home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / bbs / twast23.zip / TWASSIST.DOC < prev    next >
Text File  |  1995-12-02  |  125KB  |  3,120 lines
  1.  
  2.  
  3.                         ▄                             ▄
  4.          ▀▀█▀▀  █▀▀▄  █▀▀▀█  █▀▀▄  █▀▀▀  █▄     ▄█  █▀▀▀█  █▀▀▄  █▀▀▀
  5.            █    █▄▄▀  █▄▄▄█  █  █  █▀▀    █ ▄█▄ █   █▄▄▄█  █▄▄▀  ▀▀▀█
  6.            █    █  █ ▄█   █▄ █▄▄▀  █▄▄▄   █▄█ █▄█  ▄█   █▄ █  █  ▄▄▄█
  7.       ▄                                               ▄
  8.    ███████  ███████  ███████  ██  ███████  ██████  ███████  ██    ██  ██████
  9.    ██   ██  ██       ██       ██  ██         ██    ██   ██  ███▄  ██    ██
  10.    ███████  ███████  ███████  ██  ███████    ██    ███████  ██▀██▄██    ██
  11.    ██   ██       ██       ██  ██       ██    ██    ██   ██  ██  ▀███    ██
  12.   ███   ███ ███████  ███████  ██  ███████    ██   ███   ███ ██    ██    ██
  13.  
  14.  
  15.                                  Version 2.3
  16.  
  17.                           Trade Wars 2002 Assistant
  18.                                by Albin Gersich
  19.                 (C) Copyright 1992-1995 - Sasquatch Software
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. ╔════════════════════════════════════════════════════════════════════════════╗
  63. ║                             Table of Contents                              ║
  64. ╚════════════════════════════════════════════════════════════════════════════╝
  65.  
  66.  
  67.    1  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  68.  
  69.        1.1   Features . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  70.        1.2   Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . .   6
  71.        1.3   Acknowledgements . . . . . . . . . . . . . . . . . . . . . .   6
  72.        1.4   Trademarks . . . . . . . . . . . . . . . . . . . . . . . . .   6
  73.        1.5   Compatibility  . . . . . . . . . . . . . . . . . . . . . . .   7
  74.        1.6   Files  . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  75.        1.7   Support and Distribution . . . . . . . . . . . . . . . . . .   9
  76.        1.8   Licensing and Registration . . . . . . . . . . . . . . . . .  10
  77.  
  78.  
  79.    2  Command Arguments . . . . . . . . . . . . . . . . . . . . . . . . .  11
  80.  
  81.  
  82.    3  Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  83.  
  84.        3.1   Creating a database  . . . . . . . . . . . . . . . . . . . .  12
  85.        3.2   Using the menu . . . . . . . . . . . . . . . . . . . . . . .  12
  86.        3.3   Saving/printing reports  . . . . . . . . . . . . . . . . . .  12
  87.        3.4   Prompts and defaults . . . . . . . . . . . . . . . . . . . .  13
  88.        3.5   Misc. info . . . . . . . . . . . . . . . . . . . . . . . . .  13
  89.  
  90.  
  91.    4  Report Flags  . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  92.  
  93.  
  94.    5  (M)odify database menu  . . . . . . . . . . . . . . . . . . . . . .  15
  95.  
  96.        5.1   (E)xtract data from a capture file . . . . . . . . . . . . .  15
  97.        5.2   (A)voids . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  98.        5.3   (B)usted . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  99.        5.4   (F)ighters . . . . . . . . . . . . . . . . . . . . . . . . .  18
  100.        5.5   (M)ines  . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  101.        5.6   (L)impets  . . . . . . . . . . . . . . . . . . . . . . . . .  18
  102.        5.7   (P)orts  . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  103.        5.8   (W)arps  . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  104.        5.9   (N)otes  . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  105.        5.10  (G)ame information . . . . . . . . . . . . . . . . . . . . .  20
  106.        5.11  (S)hip information . . . . . . . . . . . . . . . . . . . . .  21
  107.        5.12  Merge another (T)rader's database  . . . . . . . . . . . . .  22
  108.        5.13  Strip database for (O)ther trader  . . . . . . . . . . . . .  23
  109.  
  110.  
  111.    6  (D)atabase summary  . . . . . . . . . . . . . . . . . . . . . . . .  24
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                   Page  2
  120.  
  121.  
  122.                           Table of Contents (contd)
  123.  
  124.  
  125.    7  (N)otes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  126.  
  127.        7.1   (V)iew notes . . . . . . . . . . . . . . . . . . . . . . . .  25
  128.        7.2   (E)dit notes . . . . . . . . . . . . . . . . . . . . . . . .  25
  129.        7.3   (S)earch notes   <Registered only> . . . . . . . . . . . . .  25
  130.  
  131.  
  132.    8  (A)sset Reports . . . . . . . . . . . . . . . . . . . . . . . . . .  26
  133.  
  134.        8.1   (F)ighter deployments  . . . . . . . . . . . . . . . . . . .  26
  135.        8.2   (M)ine deployments . . . . . . . . . . . . . . . . . . . . .  26
  136.        8.3   (L)impet deployments . . . . . . . . . . . . . . . . . . . .  26
  137.        8.4   (A)ctive Limpets . . . . . . . . . . . . . . . . . . . . . .  26
  138.  
  139.  
  140.    9  (P)ort Reports  . . . . . . . . . . . . . . . . . . . . . . . . . .  27
  141.  
  142.        9.1   (P)aired ports . . . . . . . . . . . . . . . . . . . . . . .  27
  143.        9.2   (N)earest ports  . . . . . . . . . . . . . . . . . . . . . .  27
  144.        9.3   (U)known status ports  . . . . . . . . . . . . . . . . . . .  28
  145.        9.4   (B)usted ports . . . . . . . . . . . . . . . . . . . . . . .  28
  146.        9.5   (0) Closest place to buy class 0 items . . . . . . . . . . .  28
  147.        9.6   (L)ikely major port locations  . . . . . . . . . . . . . . .  29
  148.  
  149.  
  150.   10  (S)ector Report . . . . . . . . . . . . . . . . . . . . . . . . . .  30
  151.  
  152.       10.1   (F)ull report on a sector  . . . . . . . . . . . . . . . . .  30
  153.       10.2   (N)earest sectors  . . . . . . . . . . . . . . . . . . . . .  30
  154.       10.3   (U)nexplored sectors . . . . . . . . . . . . . . . . . . . .  30
  155.       10.4   Une(x)plored clusters   <Registered only>  . . . . . . . . .  31
  156.       10.5   Un(k)nown sectors   <Registered only>  . . . . . . . . . . .  31
  157.       10.6   (W)ithout warps   <Registered only>  . . . . . . . . . . . .  32
  158.       10.7   A(v)oids . . . . . . . . . . . . . . . . . . . . . . . . . .  32
  159.       10.8   (D)end end sector analysis . . . . . . . . . . . . . . . . .  32
  160.       10.9   DE distances to (M)ajor ports  <Registered only> . . . . . .  33
  161.       10.10  (C)luster dead end analysis   <Registered only>  . . . . . .  33
  162.       10.11  (S)ecluded area analysis  <Registered only>  . . . . . . . .  34
  163.  
  164.  
  165.   11  (R)oute Reports . . . . . . . . . . . . . . . . . . . . . . . . . .  35
  166.  
  167.       11.1   (N)ormal route . . . . . . . . . . . . . . . . . . . . . . .  35
  168.       11.2   (T)ranswarp route  . . . . . . . . . . . . . . . . . . . . .  35
  169.       11.3   (S)pace lanes  . . . . . . . . . . . . . . . . . . . . . . .  35
  170.       11.4   (M)ap universe routes  . . . . . . . . . . . . . . . . . . .  36
  171.       11.5   (A)nalyze warps  . . . . . . . . . . . . . . . . . . . . . .  38
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.                                   Page  3
  180.  
  181.  
  182.                           Table of Contents (contd)
  183.  
  184.  
  185.   12  (C)ustom Reports   <Registered only>  . . . . . . . . . . . . . . .  39
  186.  
  187.       12.1   (C)opy a report  <Registered only> . . . . . . . . . . . . .  39
  188.       12.2   (D)isplay a report  <Registered only>  . . . . . . . . . . .  39
  189.       12.3   (E)xecute a report  <Registered only>  . . . . . . . . . . .  40
  190.       12.4   (M)odify a report  <Registered only> . . . . . . . . . . . .  40
  191.       12.5   (R)ead reports from another file  <Registered only>  . . . .  40
  192.  
  193.  
  194.   13  (G)raphic Displays  . . . . . . . . . . . . . . . . . . . . . . . .  41
  195.  
  196.       13.1   Display around a (S)ector  . . . . . . . . . . . . . . . . .  41
  197.       13.2   Display along a (R)oute   <Registered only>  . . . . . . . .  41
  198.  
  199.  
  200.   14  ($) Registration and configuration  . . . . . . . . . . . . . . . .  42
  201.  
  202.       14.1   Registration (N)ame  . . . . . . . . . . . . . . . . . . . .  42
  203.       14.2   Registration (C)ode  . . . . . . . . . . . . . . . . . . . .  42
  204.       14.3   (D)ESQview lines . . . . . . . . . . . . . . . . . . . . . .  42
  205.       14.4   (H)ot keys . . . . . . . . . . . . . . . . . . . . . . . . .  43
  206.       14.5   (S)creen writes  . . . . . . . . . . . . . . . . . . . . . .  43
  207.       14.6   (V)ideo driver . . . . . . . . . . . . . . . . . . . . . . .  43
  208.       14.7   (L)og file mode  . . . . . . . . . . . . . . . . . . . . . .  44
  209.  
  210.  
  211.   15  Multitasking Environments . . . . . . . . . . . . . . . . . . . . .  45
  212.  
  213.       15.1   DESQview . . . . . . . . . . . . . . . . . . . . . . . . . .  45
  214.  
  215.  
  216.   16  Automode  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  47
  217.  
  218.       16.1   Important notes about automode . . . . . . . . . . . . . . .  47
  219.       16.2   Automode commands  . . . . . . . . . . . . . . . . . . . . .  48
  220.       16.3   Automode examples  . . . . . . . . . . . . . . . . . . . . .  50
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.                                   Page  4
  240.  
  241.  
  242. ╔════════════════════════════════════════════════════════════════════════════╗
  243. ║ Section  1                    Introduction                                 ║
  244. ╚════════════════════════════════════════════════════════════════════════════╝
  245.  
  246.     Every good trader needs an assistant.  The assistant keeps records and
  247.   provides information so the trader can make better decisions.  Trade Wars
  248.   2002 (TW2002) is a bulletin board door game by Martech Software, Inc.  The
  249.   game has a lot of different aspects and keeping track of all the details by
  250.   hand can be quite tough.  I looked at utilities to help me with the game
  251.   but could not find one that met my needs or the needs of my friends, so I
  252.   decided to build one from scratch.  Trade Wars 2002 Assistant (TWASSIST)
  253.   was born.  After nine months of continuous work (with only a few sanity
  254.   breaks) version 1.0 was ready and released on October 12th, 1992.  Version
  255.   2.3 was released on December 2, 1995.
  256.  
  257.     Hopefully you will find TWASSIST user friendly and intuitive to use.  This
  258.   document will explain how to get started and what each of the functions do.
  259.   Included in some areas are tips on how the information can be used to help
  260.   you play the game.
  261.  
  262.     As with all off-line utilities of this type, they can only tell you about
  263.   the universe as you know it.  Examples are routes and distances which can
  264.   only be plotted through sectors you have warp information for, as opposed to
  265.   the Federation Navigation System in the game that knows the entire universe
  266.   and can plot courses through any sector.  As a result, distances and routes
  267.   with the utility may be longer than those reported in the game.  They will
  268.   never be shorter.  The more of the universe you have information on, the
  269.   better the utility will match the game and the more information it can
  270.   provide in the various reports.
  271.  
  272.  
  273. ░▒▓█  1.1  █▓▒░  Features
  274.  
  275.   NOTE:  Some features are available only to registered users.
  276.  
  277.     An intuitive menu structure is used to access various functions.
  278.  
  279.     The doc provides information on how to use a number of the reports in
  280.      the game.
  281.  
  282.     Create your own custom reports.
  283.  
  284.     Reports will use the entire screen if running in 43 or 50 line mode.
  285.  
  286.     Data is easily read from a capture file plus the capability to make
  287.      manual modifications.
  288.  
  289.     Easy to merge data from playing partners.  Your known data is
  290.      distinguished from merged data.
  291.  
  292.     An efficient no turn universe mapper to gather the warps for the entire
  293.      universe without exploring it.
  294.  
  295.     Automode provides a way of accessing TWASSIST from macros for your
  296.      communications program.
  297.  
  298.  
  299.                                   Page  5
  300.  
  301.  
  302.                            1.1   Features (contd)
  303.  
  304.  
  305.     Error and warning messages are in English, with any DOS message (if
  306.      applicable) added on.
  307.  
  308.     Backup data files are automatically provided.
  309.  
  310.     DESQview aware.  CPU time is given up while waiting for input.
  311.  
  312.     Supports hot keys.  User selectable.
  313.  
  314.  
  315. ░▒▓█  1.2  █▓▒░  Disclaimer
  316.  
  317.     The TWASSIST package is provided AS IS.  Sasquatch Software makes no
  318.   warranty, either expressed or implied, with respect to the software or
  319.   documentation, including but not limited to their quality, performance,
  320.   merchantability, or fitness for a particular purpose. In no event will
  321.   Sasquatch Software or the author be liable for direct, indirect, special,
  322.   incidental, or consequential damages arising out of the use, misuse, or
  323.   inability to use the software or documentation, even if advised of the
  324.   possibility of such damages.
  325.  
  326.  
  327. ░▒▓█  1.3  █▓▒░  Acknowledgements
  328.  
  329.     I would like to give thanks to Gary and Mary Ann Martin of Martech
  330.   Software, Inc. for the game, Trade Wars 2002.  It has provided me with
  331.   hours upon hours of entertainment and excitement.
  332.  
  333.     I would also like to acknowledge my beta testers, Dan Roseen and Casey
  334.   Stemp, for providing invaluable help in the initial release of this program
  335.   by discussing ideas and working out the bugs.
  336.  
  337.     Thanks to the many macro writers for their past or present contributions
  338.   of scripts to be distributed with TWASSIST:  Casey Stemp, Dan Roseen,
  339.   Jason Jiggens, Stephen Whitis, and Mark Cothran.
  340.  
  341.     Dan Roseen deserves special recognition.  He is a good friend and got me
  342.   interested in TW2002.  He convinced me of the need to develop TWASSIST and
  343.   inspired me to keep going when my morale was low and provides continuing
  344.   encouragement.
  345.  
  346.  
  347. ░▒▓█  1.4  █▓▒░  Trademarks
  348.  
  349.   DESQview is a trademark of Quarterdeck Office Systems.
  350.   IBM is a trademark of International Business Machines Corporation.
  351.   MS-DOS is a registered trademark of Microsoft Corporation.
  352.   QEMM-386 is a trademark of Quarterdeck Office Systems.
  353.   Windows is a trademark of Microsoft Corporation.
  354.  
  355.  
  356.  
  357.  
  358.  
  359.                                   Page  6
  360.  
  361.  
  362. ░▒▓█  1.5  █▓▒░  Compatibility
  363.  
  364.   Trade Wars 2002:
  365.  
  366.     This program has been tested for compatibility with TW2002 door versions
  367.     v1.03(d) and v2 beta 8, and the Major BBS version 2.  Compatibility with
  368.     other versions or modified games is not guaranteed.
  369.  
  370.   Operating system:
  371.  
  372.     TWASSIST runs on an IBM or 100% compatible PC or AT running DOS.  It
  373.     has been tested under MS-DOS versions 5.0 and 6.2.  Compatibility with
  374.     other versions or operating systems is not guaranteed.
  375.     
  376.     TWASSIST can be run in a window under DESQview.  It has been tested
  377.     under v2.26 on a 80286 PC and v2.42 on a 80386 PC.  It has also been
  378.     tested with QEMM-386 version 6.02.  For more information see the
  379.     section Multitasking Environments near the end of this document.
  380.  
  381.   RAM:
  382.  
  383.     TWASSIST allocates memory for some things as it is needed.  As a result
  384.     your memory requirements may be different than someone else's.  It will
  385.     also vary according to universe size.  The minimum memory required for a
  386.     1000 sector universe is around 250k bytes.  For a 5000 sector universe it
  387.     is around 500k bytes.  Notes will increase the amount of memory required.
  388.  
  389.     If expanded memory is available TWASSIST will load the overlay part of
  390.     the program into EMS.  EMS is not required but is recommended.  Less than
  391.     100k of EMS would be used.
  392.  
  393.   Disk:
  394.  
  395.     A hard disk is recommended, especially if you have multiple games.  It
  396.     is possible to run from a floppy based system.  Refer to the section on
  397.     files for information on file sizes.
  398.  
  399.     NOTE:  Starting with version 2.1 TWASSIST uses overlays for part of the
  400.            program.  If you don't have enough Expanded memory (EMS) the
  401.            overlays will be loaded from disk as needed.  If you are running
  402.            from floppy you should not remove the disk with the TWASSIST
  403.            program while it is running.
  404.  
  405.   Video:
  406.  
  407.     The graphic displays require VGA 640x480 or EGA/VGA 640x350 graphics.
  408.     All other parts of the program display standard text.  TWASSIST detects
  409.     the number of lines and will use all lines when displaying reports.
  410.     Testing has been done using color monitors.  Compatibility with
  411.     monochrome monitors is unknown.
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                                   Page  7
  420.  
  421.  
  422. ░▒▓█  1.6  █▓▒░  Files
  423.  
  424.     The original TWASSIST version 2.2 package distributed from Sasquatch
  425.   Software was compressed using PKZIP with authenticity verification.  When
  426.   the archive is uncompressed each file should have a "-AV" flag and a
  427.   message at the end indicating authentic files were verified that looks like
  428.   this:
  429.  
  430.       Authentic files Verified!   # CHE892
  431.       Sasquatch Software
  432.  
  433.   If you do not see the -AV and the message it is not the original archive.
  434.   It has been rearchived by someone and may or may not be a good package.
  435.  
  436.     The TWASSIST version 2.3 package (TWAST23.ZIP) contains the following
  437.   files:
  438.  
  439.     FILE_ID .DIZ       540 12-02-95   2:30a     File Id/description
  440.     TWASSIST.DOC   124,784 12-02-95   2:30a     This document
  441.     TWASSIST.EXE   259,232 12-02-95   2:30a     The executable program
  442.     TWASSIST.HIS    21,031 12-02-95   2:30a     History information
  443.     TWASSIST.REG     4,602 12-02-95   2:30a     Registration request form
  444.     TWASTMAC.DOC    39,016 12-02-95   2:30a     Com. program macros document
  445.     TWASTMAC.ZIP    24,431 12-02-95   2:30a     Com. program macros
  446.  
  447.   Files created by the program:
  448.  
  449.     TWASSIST.CFG    Configuration file.  This file is created in the same
  450.                     directory the program is located in.  Size is 256 bytes.
  451.  
  452.     TWASSIST.CFK    Backup of the configuration file.
  453.  
  454.     game.DAT        The database file of game information.  Each game will
  455.                     have a separate database file.  The 'game' part of the
  456.                     name is chosen by the user.  File size will depend on the
  457.                     size of the universe and the number of notes.  For a 1000
  458.                     sector universe the size can vary from 40k to 160k
  459.                     depending on the amount of notes.  A 5000 sector universe
  460.                     will start at 200k and can go much higher with notes
  461.                     (limited by the amount of conventional memory in your
  462.                     computer).
  463.  
  464.     game.BAK        Backup of the database file.
  465.  
  466.     game.CIM        File of route commands to be sent to the game while using
  467.                     the universe mapper.
  468.  
  469.     game.CUS        Custom reports file.  Size is 604 bytes.
  470.  
  471.     game.CUK        Backup of the custom reports file.
  472.  
  473.     game.LOG        A log file of the messages while extracting from a capture
  474.                     file or merging another traders database.  This is useful
  475.                     if you want to go back and check on some errors or other
  476.                     info.
  477.  
  478.  
  479.                                   Page  8
  480.  
  481.  
  482.                              1.6   Files (contd)
  483.  
  484.  
  485.     game.RPT        The default name used for the report file.  The actual
  486.                     name is chosen during runtime.  It can be anything,
  487.                     except for some reserved extensions shown in this list.
  488.                     More than one report file can be used by providing
  489.                     different names.  Sizes will vary.
  490.  
  491.  
  492. ░▒▓█  1.7  █▓▒░  Support and Distribution
  493.  
  494.     Updates and/or new releases of TWASSIST can be downloaded or file
  495.   requested from the support BBS identified below.  If you are logging in,
  496.   you will have to fill out a new user questionnaire.  Once you have done
  497.   this you will have enough access to download TWASSIST without complete
  498.   user verification.  Enter messages in the Private E-mail conference or
  499.   send a Comment to Sysop.
  500.  
  501.     If you are experiencing problems, call the BBS or write and include the
  502.   following information:
  503.  
  504.      ■ A detailed explanation of the problem.
  505.      ■ The game files:       game.DAT and, if you have one, game.CUS
  506.      ■ Configuration file:   TWASSIST.CFG (from the program directory)
  507.  
  508.   Mail can be sent to:
  509.  
  510.      Sasquatch Software
  511.      P.O. Box 4331
  512.      Kent, WA  98032-9331
  513.  
  514.   Support and Distribution:
  515.   ─────────────────────────
  516.  
  517.   Sysop:       Albin Gersich
  518.  
  519.   BBS:         The Harry Beast
  520.  
  521.   Login:       (206)859-6157      Kent, WA - USA
  522.                23 hrs (Mail hour 1-2AM PST or 2-3AM PDT)
  523.                14.4k V.32bis/V.42bis
  524.  
  525.   Fidonet:     1:343/102
  526.   Internet:    albin.gersich@f102.n343.z1.fidonet.org
  527.  
  528.   Comment:     For downloading latest version:  Download TWAST*.ZIP
  529.                           For file-requesting:  Use the magic name "TWASSIST"
  530.                                                 or request TWAST*.ZIP
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.                                   Page  9
  540.  
  541.  
  542. ░▒▓█  1.8  █▓▒░  Licensing and Registration
  543.  
  544.     The software and documentation is copyrighted and is protected by United
  545.   States copyright laws and international treaty provisions.  All rights
  546.   are reserved by Sasquatch Software.  The software is owned by Sasquatch
  547.   Software and title remains in Sasquatch Software.  You may distribute
  548.   unregistered versions of the program as long as the entire package (as
  549.   described in the section titled Files) is distributed together and no fee
  550.   is charged for the software (a nominal distribution or shipping fee is ok).
  551.   Distribution of registration codes, methods of defeating the registration
  552.   mechanism, or modified files is illegal.  Distribute the package as it was
  553.   released.  Do not add, delete, or modify files.   You may not decompile,
  554.   disassemble, modify, merge, or reverse engineer the software in any way.
  555.                           
  556.     A registration fee is required to use all the features of TWASSIST.
  557.   There are a lot of unregistered features so you can get a feel for the
  558.   program before you decide to register.  If you purchase a registration code
  559.   you will be granted a license to use all the features of TWASSIST.  If you
  560.   decide not to register you are granted a license to continue to use the
  561.   unregistered features of TWASSIST.  The registered only menu items will
  562.   have the text "<Registered only>" on the right.  You will not be able to
  563.   select these menu items.  If the program is registered the registered only
  564.   text will be removed from the menu.
  565.  
  566.     Registration is a one time fee.  Once you register it will be good for
  567.   all future versions of this program.  One registration may be used by all
  568.   members of a household but it may be used on only one computer at a time.
  569.   If it is to be used by multiple people on multiple computers a registration
  570.   is required for each.  Registrations are not transferable.
  571.  
  572.     The registration price is US$15.  Sales tax for residents of Washington
  573.   state will be paid by Sasquatch Software.  For my good friends to the north
  574.   I will accept Canadian dollars or they may pay in U.S. dollars.  The price
  575.   in Canadian dollars is C$19.  Residents outside the United States and
  576.   Canada must pay in U.S. dollars.
  577.  
  578.     Those who do not want to register, but wish to provide incentive for the
  579.   development of utilities, may contribute in any amount they desire.  Print
  580.   out the registration order form, follow its instructions, and fill in the
  581.   blank for the amount of the contribution.
  582.  
  583.     Please send a check or money order in U.S. (or Canadian) funds.  If
  584.   payment is made by personal check the registration code will not be sent
  585.   until the check clears.  Personal checks will only be accepted if they are
  586.   drawn on U.S. or Canadian banks.  Residents outside the U.S. and Canada may
  587.   pay using a bank check with funds drawn on a U.S. bank or using an
  588.   international money order denominated in U.S. funds.  Cash is discouraged.
  589.   The sender takes all responsibility for the payment reaching Sasquatch
  590.   Software.  Print the registration order form, TWASSIST.REG, fill it out and
  591.   follow the instructions on the form.  Please allow up to four weeks (longer
  592.   outside the U.S. and Canada) for delivery of your registration code.
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                                   Page 10
  600.  
  601.  
  602. ╔════════════════════════════════════════════════════════════════════════════╗
  603. ║ Section  2                   Command Arguments                             ║
  604. ╚════════════════════════════════════════════════════════════════════════════╝
  605.  
  606.     TWASSIST will accept various parameters and options on the command line.
  607.   You do not have to provide any.  If you run TWASSIST without any arguments
  608.   it will prompt for the database (game) name.
  609.  
  610.   Legend:
  611.  
  612.       []        Brackets represent an optional item.
  613.  
  614.       UPPER     Upper case letters must be typed exactly (although you may
  615.                 use upper or lower case letters).
  616.  
  617.       lower     Lower case letters represent a parameter you provide a value
  618.                 for.
  619.  
  620.       ...       Ellipsis mean the previous item may be repeated.  You can
  621.                 provide multiple values by separating each with a space.
  622.  
  623.   Format:
  624.  
  625.       TWASSIST  [database[.DAT] [/A[,cmd_file | automode_commands...]]
  626.  
  627.           database[.DAT]
  628.  
  629.               The name of the database to be used to store game data.  The
  630.               file must have a .DAT extension although you don't need to
  631.               provide the .DAT extension on the command line.  If the
  632.               database name is not provided on the command line the program
  633.               will prompt you for it.  You may include directory paths (e.g.
  634.               C:\TW\NIGHTOWL).  If the file does not exist you will be asked
  635.               to verify if you want to create a new database.
  636.  
  637.           /A
  638.  
  639.               The /A option specifies TWASSIST to run in automode.  Automode
  640.               is a way of providing commands for TWASSIST to execute without
  641.               bringing up the interactive menu.  This is very useful for
  642.               macros while on-line like the universe mapper.  Everything
  643.               following the /A is interpreted as automode commands.  You can
  644.               specify automode commands two ways.  One is to provide a file
  645.               of automode commands, the cmd_file, or you can specify the
  646.               automode commands directly on the command line separating them
  647.               with spaces.  See the section on Automode for more information.
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.                                   Page 11
  660.  
  661.  
  662. ╔════════════════════════════════════════════════════════════════════════════╗
  663. ║ Section  3                   Getting Started                               ║
  664. ╚════════════════════════════════════════════════════════════════════════════╝
  665.  
  666.  
  667. ░▒▓█  3.1  █▓▒░  Creating a database
  668.  
  669.     If you are creating a new database the program will display a special
  670.   Initialization menu.  Before you can enter any data or do any of the reports
  671.   the size of the universe must be set.  You can do this manually using the
  672.   (S)et universe size menu item or let the program do it by reading the View
  673.   Game Status report by (E)xtracting data from a capture file.  After the
  674.   universe size has been set the (M)odify Database Menu will be displayed.
  675.   Once the size is set it can not be changed.  TWASSIST supports a universe
  676.   size of up to 5000 sectors.
  677.  
  678.  
  679. ░▒▓█  3.2  █▓▒░  Using the menu
  680.  
  681.     TWASSIST uses a menu hierarchy with related functions grouped together in
  682.   a menu.  Each menu item has a highlighted letter within parenthesis.  To
  683.   execute a particular item enter the highlighted letter and press return (a
  684.   return will not be required if hot keys are enabled).
  685.  
  686.  
  687. ░▒▓█  3.3  █▓▒░  Saving/printing reports
  688.  
  689.     Some of the reports allow output to be sent to a file.  They will have an
  690.   asterisk (*) on the left of the menu item.  To send the output to the file,
  691.   enter an asterisk first and then the highlighted letter for the menu item
  692.   (e.g. *D).  You will be prompted for the file name.  The report will still
  693.   be displayed on the screen.  If you stop the screen output, by saying no
  694.   when asked for more, the output to the file will also be stopped.  To get a
  695.   printed report you can either send the report to a file and print the file
  696.   or specify your printer device (e.g. LPT1, PRN) as the filename for the
  697.   report.
  698.  
  699.   WARNING:  If there is a problem in writing to the file (or printer) you
  700.             will see the DOS abort, retry, or fail message.  You should
  701.             select fail (it may be required to do this more than once).  If
  702.             you select abort, DOS will abort the entire program.  TWASSIST
  703.             will have no control over what is happening and all modifications
  704.             in memory that have not been saved to disk will be lost.
  705.  
  706.     To print one of the graphics displays you need to have a TSR or some
  707.   program running that can capture the display and format it for a printer.
  708.   Refer to the section on Graphics Displays for more information.
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.                                   Page 12
  720.  
  721.  
  722. ░▒▓█  3.4  █▓▒░  Prompts and defaults
  723.  
  724.     Throughout the program there are places where you are asked to provide a
  725.   response.  If the prompt is for a number the default value will be shown in
  726.   brackets (e.g. [30]).  Multiple choices in brackets will be separated by a
  727.   slash (/) with the default shown in caps (and highlighted) and the other
  728.   options in lower case (e.g. [y/N]).  To use the default simply press Enter.
  729.   Single letter defaults may also be used by pressing the space bar.
  730.  
  731.     When prompted for a sector number you will be shown the location of the
  732.   Stardock for easy reference.  The sector number you enter will be remembered
  733.   and used as the default the next time you are prompted for a sector number.
  734.   Destination sector numbers will be remembered separate from starting or
  735.   reference sector numbers.  By remembering the sector number you can easily
  736.   get a number of reports using the same sector without having to remember or
  737.   retype the number.
  738.  
  739.     Each report is displayed in screens with a prompt asking if you want to
  740.   see more.  The responses are Y for yes, N for no, and C for continuous.  If
  741.   you select continuous, the report will continue without prompting until the
  742.   end is reached.  At the end of the report the program will pause.  This is
  743.   useful if you want to get to the final screen of the report or you want to
  744.   send the entire report to a file and review it later.
  745.  
  746. ░▒▓█  3.5  █▓▒░  Misc. info
  747.  
  748.     A number of the reports show a set of flags for each of the displayed
  749.   sectors.  See (S)ector Reports for a description of these flags.
  750.  
  751.     If a distance can not be computed, either due to an avoid or not having
  752.   warp enough warp information, the distance will be shown as three question
  753.   marks.
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.                                   Page 13
  780.  
  781.  
  782. ╔════════════════════════════════════════════════════════════════════════════╗
  783. ║ Section  4                     Report Flags                                ║
  784. ╚════════════════════════════════════════════════════════════════════════════╝
  785.  
  786.     A number of the reports display flags of information about the sectors.
  787.   If a sector does not have a particular flag a period will be shown in place
  788.   of that flag.  The flags are:
  789.  
  790.                   DCT
  791.                   DEC
  792.     UX            DET C0
  793.     UP            BD  SL
  794.     UW A B MLA Fx DEn SD
  795.     ^  ^ ^ ^   ^  ^   ^
  796.     │  │ │ │   │  │   └───── SD  = Sector is Stardock.
  797.     │  │ │ │   │  │          SL  = Sector is in space lane.
  798.     │  │ │ │   │  │          C0  = Sector has class 0 port.
  799.     │  │ │ │   │  │
  800.     │  │ │ │   │  └───────── DEn = Sector is a dead end of depth 'n'
  801.     │  │ │ │   │             BD  = Sector has a back door.  There is one or
  802.     │  │ │ │   │                   more one way warps into the sector.
  803.     │  │ │ │   │             DET = Sector is in a tunnel to a dead end.
  804.     │  │ │ │   │             DEC = Sector is a dead end cluster <Registered
  805.     │  │ │ │   │                   only>.
  806.     │  │ │ │   │             DCT = Sector is in a tunnel to a dead end cluster
  807.     │  │ │ │   │                   <Registered only>.
  808.     │  │ │ │   │
  809.     │  │ │ │   └──────────── Fx  = Deployed fighters where 'x' is the mode,
  810.     │  │ │ │                       O = Offensive, D = Defensive, T = Toll.
  811.     │  │ │ │
  812.     │  │ │ └──────────────── M   = Deployed mines.
  813.     │  │ │                   L   = Deployed Limpets.
  814.     │  │ │                   A   = Active Limpets.
  815.     │  │ │
  816.     │  │ └────────────────── B   = Port has busted date.
  817.     │  │
  818.     │  └──────────────────── A   = Sector is an avoid.
  819.     │
  820.     └─────────────────────── UX  = Sector is unexplored and has no warps.
  821.                              UP  = Sector is unexplored and has partial warps
  822.                                    built from course plots.  All warps may
  823.                                    not be known.
  824.                              UW  = Sector is unexplored and has warps either
  825.                                    from merging databases or from manual
  826.                                    entry.
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.                                   Page 14
  840.  
  841.  
  842. ╔════════════════════════════════════════════════════════════════════════════╗
  843. ║ Section  5                (M)odify database menu                           ║
  844. ╚════════════════════════════════════════════════════════════════════════════╝
  845.  
  846.     Most of the modifications will be handled automatically by extracting
  847.   information from a capture file.  Functions are also provided to allow you
  848.   to make individual changes to the database.  When making individual changes
  849.   the defaults will be the current values in the database.  If you make a
  850.   mistake and don't want to make changes, you can just accept the defaults.
  851.   If the new values differ from the old values, you will be shown both values
  852.   and prompted if you want to modify the database.  This gives you another
  853.   chance to verify your data before the changes are applied.  The default
  854.   response is no so you don't accidently make changes you don't want.  This is
  855.   to preserve what is in the database unless you specifically request it to be
  856.   changed.
  857.  
  858.     When you quit the (M)odify Database Menu the program will check to see if
  859.   some tables need to be updated.  The computations for determining dead ends
  860.   will take a while if they need to be recomputed and a status bar will show
  861.   the progress.  After the tables are done a flag will be checked to see if
  862.   any changes have been made to the database that have not been saved to the
  863.   file on disk.  You will be prompted if you want to save the changes to the
  864.   file.  If you are making minor changes real time while on-line or are
  865.   experimenting, you may not want to save it right away.  The first save of
  866.   the session will cause the old data file to be renamed as a backup.  If you
  867.   do not save the database the flag will not be reset so each time you quit
  868.   the modify menu you will again be prompted to save the database to the file,
  869.   even if no additional changes were made.  The changes are kept in memory so
  870.   the reports will use the changes even if they are not saved to the file.
  871.   As an extra precaution you will be prompted again when you exit the program.
  872.  
  873.  
  874. ░▒▓█  5.1  █▓▒░  (E)xtract data from a capture file
  875.  
  876.     The (E)xtract data from a capture file function in the modify database
  877.   menu will read various reports from a TW2002 session captured to a file.
  878.   TWASSIST will extract information from the reports and update the database
  879.   accordingly, reporting status to the screen as it progresses.  How you make
  880.   this capture file will depend on the communications program you are using.
  881.   Refer to its documentation.  Generaly you press a special key and it prompts
  882.   for a file name.  Once turned on everything that is displayed on the screen
  883.   is also being captured to the file.  After you get all the information you
  884.   want in the file you generally press a special key, sometimes the same one,
  885.   to turn off the capture.  The following reports from TW2002 can be read:
  886.  
  887.     From the main menu:
  888.  
  889.        (V)  View Game Status
  890.        (G)  Show Deployed Fighters
  891.        (K)  Show Deployed Mines
  892.             (The Armid mine scan for TW2002 v1.03(d) and the Armid and both
  893.              Limpet scans for TW2002 v2.)
  894.  
  895.  
  896.  
  897.  
  898.  
  899.                                   Page 15
  900.  
  901.  
  902.                5.1   (E)xtract data from a capture file (contd)
  903.  
  904.  
  905.     From the computer menu:
  906.  
  907.        (X)  List Current Avoids
  908.             (Also the avoid sectors list displayed when you enter the game.)
  909.  
  910.     From computer interrogation mode (CIM - see below):
  911.  
  912.        (I)  Sector report
  913.        (R)  Port report
  914.  
  915.     WARNING:  There is a bug in v1.03(d) of TW2002 that if you do a CIM R
  916.               report before getting status on a port you will be kicked out
  917.               of the game and back to the BBS.  To prevent this, either port
  918.               at a port or use the computer to get the status of a port.
  919.               It can be any port except a class 0 port.
  920.  
  921.     NOTE:  The location of the class 0 ports are not shown in any of the above
  922.            reports.  You will have to modify the database manually to declare
  923.            their locations (sector 1 is predefined by TWASSIST to be a class 0
  924.            port so you don't need to enter that one).  If the location of the
  925.            stardock is not shown in the View Game Status it will also have to
  926.            be done manually.
  927.  
  928.     Entering CIM:
  929.  
  930.         CIM is a computer mode in TW2002.  It allows you to interrogate the
  931.       computer for information about sector warps and port information of
  932.       your known universe.  To enter CIM you need to go to the computer
  933.       command prompt in the game and enter ASCII characters 200 thru 205.
  934.       To enter one of these characters hold down the ALT key, type the number
  935.       of the character (e.g. 200) using the keys on the number pad (not the
  936.       upper row!), and then release the ALT key.  To enter CIM you would do:
  937.  
  938.                 ALT down, num pad 200, ALT up
  939.                 ALT down, num pad 201, ALT up
  940.                 ALT down, num pad 202, ALT up
  941.                 ALT down, num pad 203, ALT up
  942.                 ALT down, num pad 204, ALT up
  943.                 ALT down, num pad 205, ALT up
  944.  
  945.       Some communications programs, particularly Windows versions, use the
  946.       ALT key (e.g. to activate menus) or do not allow the transmission of
  947.       high ASCII characters.  I don't know ways to get around the limitations
  948.       of every program.  One possibility is to use a DOS editor to create a
  949.       text file containing these characters and do an ASCII upload of this
  950.       file.  If you need help you need to find someone who is knowledgeable
  951.       about your communications program.
  952.  
  953.         Once in CIM you will see a colon prompt.  CIM will respond to it's
  954.       own set of commands.  Enter an I character to get a report on sector
  955.       warps, an R character to get a report on port information, an F
  956.       character to plot a course similar to using the regular computer
  957.       command, and a Q character to quit CIM.
  958.  
  959.                                   Page 16
  960.  
  961.  
  962.               5.1   (E)xtract data from a capture file (contd)
  963.  
  964.     You can make a capture file of just the above reports or you can capture
  965.   the entire TW2002 session.  The program will find the parts it can use.  It
  966.   is not necessary to separate them into different files.  The extract routine
  967.   will look for certain key phrases or prompts to determine what information
  968.   is in the capture file and the beginning and ending of the reports.  Usually
  969.   it is the title of the report.  For CIM it needs the colon prompt as well as
  970.   the ": ENDINTERROG" message.  If you do a complete capture of your session
  971.   this should not be a problem.  If you turn the capture on and off to get
  972.   just the reports get the prompts before and after the reports, including the
  973.   CIM prompts and end message, to be sure TWASSIST can properly find and
  974.   process the data.  A number of macros for communications program are
  975.   provided to help capture this information.  Refer to the file TWASTMAC.DOC
  976.   which came with this program for more information.
  977.  
  978.     When you extract information from a capture file, you will be prompted
  979.   for the pathname of the capture file.  The file can be any name.  As the
  980.   file is read, the line number of the capture file and a status message will
  981.   be displayed indicating what is being extracted.  At times, messages will
  982.   also be displayed providing information on some of the changes found.
  983.   Warning messages will be displayed if the data is inconsistent with the
  984.   database.  Error messages will be displayed if there are problems reading
  985.   the data from the capture file.  If there are errors while extracting data,
  986.   use a text editor to view the capture file at the line indicated, make any
  987.   changes necessary, and try again to extract data from the capture file.
  988.  
  989.     The messages during an extract or merge will be copied to a log file.
  990.   The log file has the same name as the database but with a .LOG extension.
  991.   This makes it easy to investigate errors or other information.  Setting
  992.   the configuration section for setting append or overwrite for each session.
  993.  
  994.  
  995. ░▒▓█  5.2  █▓▒░  (A)voids
  996.  
  997.     The (A)voids function in the modify database menu will allow you to add
  998.   or remove sectors from the avoids list.  When you select this function, a
  999.   list of the avoids will be displayed.  You will be prompted for a sector
  1000.   number and then asked if the sector should be avoided.
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.                                   Page 17
  1020.  
  1021.  
  1022. ░▒▓█  5.3  █▓▒░  (B)usted
  1023.  
  1024.     The (B)usted function in the modify database menu will allow you to enter
  1025.   or change the busted date for a port.  You will be prompted for a sector
  1026.   number.  You will not be allowed to enter a busted date if the sector does
  1027.   not have a port defined.  If the sector already has a busted date it will
  1028.   be shown and you will be asked if you want to delete or change it.  The
  1029.   date the last time port records were cleared of busted names (see (B)usted
  1030.   ports in (P)ort Reports) will be shown.  If the last clear date has not
  1031.   been set in the database, you will be shown the date 14 days before the
  1032.   current date.  Which ever date is shown, you will not be allowed to enter
  1033.   any busted date prior to it since those port records would have already
  1034.   been cleared.  You will be prompted for the date busted.  Initially the
  1035.   default will be the current date.  If you enter a different date, that date
  1036.   will be kept as the default for the session until you enter another date.
  1037.   This was done because you may be entering a series of busted ports written
  1038.   down on scratch paper from an earlier day's game play.  After you enter the
  1039.   busted date you will be shown the old and new dates and asked if the
  1040.   database is to be modified.
  1041.  
  1042.  
  1043. ░▒▓█  5.4  █▓▒░  (F)ighters
  1044.  
  1045.     The (F)ighters function in the modify database menu will allow you to
  1046.   change the number of deployed fighters in a sector and the fighter mode.
  1047.   You will be prompted for a sector number and then be shown the current
  1048.   number of fighters there and their mode.  Next you are prompted to enter
  1049.   the new number of fighters, a units modifier, and the new mode.  After
  1050.   entering the new values you will be shown the old and new values and
  1051.   asked if the database is to be modified.
  1052.  
  1053.  
  1054. ░▒▓█  5.5  █▓▒░  (M)ines
  1055.  
  1056.     The (M)ines function in the modify database menu will allow you to change
  1057.   the number of deployed mines in a sector.  You will be prompted for a sector
  1058.   number and then shown the current number of mines there.  Next you are
  1059.   prompted to enter the new number of mines.  After entering the new value you
  1060.   will be shown the old and new values and asked if the database is to be
  1061.   modified.
  1062.  
  1063.  
  1064. ░▒▓█  5.6  █▓▒░  (L)impets
  1065.  
  1066.     The (L)impets function in the modify database menu will allow you to
  1067.   change the number of deployed and activated Limpets in a sector.  You will
  1068.   be prompted for a sector number and then shown the current number of
  1069.   deployed and activated Limpets.  Next you are prompted for new values.
  1070.   After entering the new values you will be shown the old and new values and
  1071.   asked if the database is to be modified.
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.                                   Page 18
  1080.  
  1081.  
  1082. ░▒▓█  5.7  █▓▒░  (P)orts
  1083.  
  1084.     The (P)orts function in the modify database menu will allow you to add a
  1085.   port to a sector, change the port class, or remove a port from a sector.
  1086.   You will be prompted for a sector number.  The current port class (if any)
  1087.   for the sector will be displayed.  A list of port classes and the buys and
  1088.   sells for the products will be shown.  There is a limit of one Stardock and
  1089.   3 class 0 ports.  If the database already has the maximum number for one of
  1090.   these port classes, a note will be shown next to that class and that class
  1091.   will be disabled for entry.  You will be prompted for the new port class.
  1092.   After entering a new port class you will be shown the old and the new
  1093.   classes and asked if the database is to be modified.
  1094.  
  1095.     Since you can not get reports of port status if someone has a fighter
  1096.   deployed in the sector (see (U)nknown status ports in (P)ort Reports), you
  1097.   will have to manually enter these ports if you come across them.  For
  1098.   example, if you see a large density and do a holoscan you may see enemy
  1099.   fighters deployed in the sector and a port.  If you do not take out the
  1100.   fighters you will not get the port information in the CIM report so extract
  1101.   will not know a port is there.  You will have to manually enter the port
  1102.   class based on what you saw with the holoscan.
  1103.  
  1104.   NOTE:  Any port whose class is entered or changed manually will be flagged
  1105.          as having unknown status.  The status will be changed to known if
  1106.          the information appears in a CIM report.  The only exceptions to
  1107.          this is changing from a class 8 to a class 9 Stardock port or
  1108.          vice-versa.  The CIM report for a class 8 and class 9 are the same
  1109.          so the information is still valid.
  1110.  
  1111.  
  1112. ░▒▓█  5.8  █▓▒░  (W)arps
  1113.  
  1114.     The (W)arps function in the modify database menu will allow you to enter
  1115.   or change the warps of a sector.  You will be prompted for a sector number
  1116.   and shown the current warps (if any).  Enter the new warps on a single line
  1117.   separating them with spaces.  Entering the number 0 (as the first and only
  1118.   warp) will cause all warps to be deleted.  After entering the warps you will
  1119.   be shown the old and new warps.  If the sector is explored a message will be
  1120.   displayed saying that if you save the warp changes the sector will be marked
  1121.   as unexplored.  Only warp information read in a CIM report while extracting
  1122.   from a capture file will mark a sector as explored.  You will then be asked
  1123.   if the database is to be modified.
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.                                   Page 19
  1140.  
  1141.  
  1142. ░▒▓█  5.9  █▓▒░  (N)otes
  1143.  
  1144.     The (N)otes function in the modify database menu will allow you to enter,
  1145.   delete, or change a note for a sector.  You can have one note for each
  1146.   sector (more notes take more memory and more disk space).  Each note can
  1147.   have up to 120 characters.  The first 6 of these characters are taken up by
  1148.   a date which is automatically inserted.  The date is of the form "mm/dd "
  1149.   and is the date read from the system clock at the time you enter the note.
  1150.  
  1151.     You will be prompted for a sector number.  If there is no note for the
  1152.   sector you will be asked if you want to create one.  If there is a note it
  1153.   will be displayed and you will be asked if you want to delete or change it.
  1154.   After entering the note you will be shown the old note and the new note and
  1155.   asked if the database is to be modified.
  1156.  
  1157.     There are several note features that are included for your convenience.
  1158.   These include being able to backspace over the date if it is not wanted or
  1159.   more space is desired, backspacing up to the previous line, automatic word
  1160.   wrap when a note is viewed, and more.
  1161.  
  1162.  
  1163. ░▒▓█  5.10  █▓▒░  (G)ame information
  1164.  
  1165.     The (G)ame information function in the modify database menu will allow
  1166.   you to change the game version, game registration status, the number of
  1167.   planets, and the number of citadels.  The game version and registration
  1168.   status are used to determine if the shipyards are open in the Stardock.
  1169.   The number of planets and citadels is for your information only.  They are
  1170.   not used in this version of TWASSIST.  The status date shown in the game
  1171.   information section of the database summary is also for your information
  1172.   only.  It can not be changed manually but if you modify any of the game
  1173.   information parameters it will be changed to say "Manually modified on
  1174.   MM/DD".  This is to indicate the game information in the summary was not
  1175.   extracted from a configuration status report in a capture file.
  1176.  
  1177.     When you first select game information, you will be given a list of the
  1178.   things you can modify and their current values.  Select the one you wish to
  1179.   modify.
  1180.  
  1181.     If you select (V)ersion you will be prompted for the new version.  Do not
  1182.   append any letters to the game version.  After entering the new version
  1183.   you will be shown the old and new values and asked if you want to modify
  1184.   the database.
  1185.  
  1186.     If you select (R)egistered it will automatically toggle to the opposite
  1187.   value (since there is only one other choice for a YES/NO value).  You will
  1188.   be shown the old and new values and asked if the database is to be modified.
  1189.  
  1190.     If you select (P)lanets, you will be asked for the new number.  Since
  1191.   Terra must always exist the minimum value is 1.  When you change the number
  1192.   of planets, the citadel percentage will be recalculated so the number of
  1193.   citadels remains the same.  If you lower the number of planets so that the
  1194.   number of citadels exceeds the maximum allowed, the number of citadels will
  1195.   be lowered to the maximum and the percentage calculated accordingly.  After
  1196.   entering the new value you will be shown the old and new values along with
  1197.  
  1198.  
  1199.                                   Page 20
  1200.  
  1201.  
  1202.                        5.10  Game information  (contd)
  1203.  
  1204.  
  1205.   the changes to the citadel numbers.  You will then be asked the database is
  1206.   to be modified.
  1207.  
  1208.     If you select (C)itadels, you will be asked for the new percentage.  The
  1209.   maximum number of citadels is one less than the number of planets (since
  1210.   Terra can not have a citadel) and the maximum percentage will be calculated
  1211.   based on this number.  You will not be able to enter a percentage that is
  1212.   impossible based on the number of planets.  For example, with 5 planets you
  1213.   can not have 50% citadels.  If the value is impossible, two possible values
  1214.   just above and just below the value you entered will be shown and you will
  1215.   be prompted to reenter the new percentage. After entering the new percentage
  1216.   you will be shown the old and new values and asked if the database is to be
  1217.   modified.
  1218.  
  1219.     If you select (D)ays, you will be asked for the number of days the game
  1220.   has been running and the corresponding month and day.  You will then be
  1221.   shown the old game days and the new information and asked if the database
  1222.   is to be modified.  It is not recommended you change the game days.  This
  1223.   information is used for determining the port busts clearing cycle.  Once
  1224.   the cycle is known TWASSIST will automatically keep it up to date and it
  1225.   will be verified every time a View Game Status is read from a capture file.
  1226.   Modify the (D)ays only if you want to the cycle to be calculated, because
  1227.   you have not had a View Game Status in a capture file, or if you think the
  1228.   cycle may have changed and don't have a new View Game Status.
  1229.  
  1230.  
  1231. ░▒▓█  5.11  █▓▒░  (S)hip information
  1232.  
  1233.     The (S)hip information function in the modify database menu allows you to
  1234.   change the ship flags shown in the database summary.  These flags are
  1235.   yes/no values.  Both of these flags are just yes/no values.  When you select
  1236.   either one it will automatically toggle to the opposite value.  You will be
  1237.   shown the old and new values and asked if the database is to be modified.
  1238.  
  1239.   Trans(w)arp
  1240.  
  1241.      Registered only.  It is used by some of the reports to determine if
  1242.      transwarp information should be computed and displayed.  This flag has
  1243.      no affect on the (T)ranswarp route to a sector in (R)oute Reports, which
  1244.      can always be used.  Two of the port reports, (P)aired ports and (0)
  1245.      Closest place to buy class 0 items, and the custom reports will use the
  1246.      flag.  The transwarp information in these reports is an extra, all the
  1247.      other information in these reports will still be available.  The
  1248.      transwarp computations can be lengthy.  If your ship does not have
  1249.      transwarp, or if you have a slower computer and don't want this
  1250.      information all the time, set the transwarp flag to no.
  1251.  
  1252.   Twarp to toll (f)ighter
  1253.  
  1254.      This flag is used to determine if a toll fighter can be used as a
  1255.      destination for transwarping.  People who leave toll fighters around and
  1256.      don't mind transwarping to one can set this flag to yes.  Others that
  1257.  
  1258.  
  1259.                                   Page 21
  1260.  
  1261.  
  1262.                        5.11  Ship information  (contd)
  1263.  
  1264.  
  1265.      don't like the idea of someone paying the toll and leaving 99 mines
  1266.      behind for them to transwarp into may prefer to set this to no.  This
  1267.      depends on the kind of competition in your game and your personal
  1268.      preferences.  The default value is no.  Offensive and defensive fighters
  1269.      will automatically be used for transwarping.
  1270.  
  1271.    Twarp to Fed. (s)pace
  1272.  
  1273.      This flag is used by the transwarp routines.  In TW2002 v2 games a
  1274.      commisioned officer can transwarp directly to Federation Space.  If this
  1275.      flag is set to yes, the transwarp routines will consider the Federation
  1276.      sectors as possible transwarp locations in addition to your fighters.
  1277.  
  1278.  
  1279. ░▒▓█  5.12  █▓▒░  Merge another (T)rader's database
  1280.  
  1281.     The Merge another (T)rader's database function in the modify database
  1282.   menu will read in another TWASSIST database and merge the information into
  1283.   yours.  Traders in a corporation or even individual traders working together
  1284.   can share their knowledge of the universe.  TWASSIST relies heavily on warp
  1285.   information.  The more sectors in the universe you have warps for, the more
  1286.   information TWASSIST can provide and the more accurate it can be.  Merging
  1287.   provides a very easy way to fill in the information on the universe.
  1288.  
  1289.     Only sector warps, port classes, and notes are merged.  Other information
  1290.   like deployed fighters, deployed mines, and game information may not be
  1291.   relevant to you and you can easily get this information from the reports in
  1292.   the game.  The idea is to get information on unexplored sectors to fill in
  1293.   the gaps in your information and to check their notes to see if there is
  1294.   something of value in them.  When warps for a sector are copied, the sector
  1295.   will still be marked unexplored to agree with the game.  It will be
  1296.   considered unexplored with warps (see (S)ector Reports).  Ports copied will
  1297.   be marked as unknown status (see (U)known status ports in (P)ort Reports).
  1298.   You will know the class of the port but not the product quantities.  The
  1299.   paired ports will not be able to compute a factor on it and the custom
  1300.   reports will not be able to do any comparisons on the quantities.  If you
  1301.   explore the sector and the port shows up in a CIM, it will then be marked
  1302.   as known status.
  1303.  
  1304.     When you merge databases you will be prompted for the filename of the
  1305.   database to read.  TWASSIST will load the database into memory and then
  1306.   start the merge.  During the merge, sector warp information and port
  1307.   classes will be read from both databases.  If the information exists in
  1308.   the other database but not in yours it will be copied into yours.  If the
  1309.   information exists in both databases it will be compared.  If both
  1310.   databases compare nothing happens.  If there is a difference you will see
  1311.   a warning message telling what type of difference was found and the action
  1312.   taken.  After going through all the sectors the notes will be merged.  If
  1313.   the same note exists in both databases (maybe from a previous merge)
  1314.   nothing happens.  If the other database has a note for a sector and your
  1315.   database does not or the notes are different, the notes will be displayed
  1316.  
  1317.  
  1318.  
  1319.                                   Page 22
  1320.  
  1321.  
  1322.                  5.12  Merge another Trader's database  (contd)
  1323.  
  1324.  
  1325.   and you will be asked whether or not you want to copy their note.  After
  1326.   the merge is complete, status information will be displayed telling you
  1327.   how many sectors with warps, ports, and notes were copied from the other
  1328.   database.
  1329.  
  1330.     The messages during an extract or merge will be copied to a log file.
  1331.   The log file has the same name as the database but with a .LOG extension.
  1332.   This makes it easy to investigate errors or other information.  Setting
  1333.   the configuration section for setting append or overwrite for each session.
  1334.  
  1335.  
  1336. ░▒▓█  5.13  █▓▒░  Strip database for (O)ther trader
  1337.  
  1338.     This function creates a special database with some data from the current
  1339.   database but not all of it.  It is useful if you want to trade databases
  1340.   with a partner that is not in your corporation.  You don't necessarily want
  1341.   to give another player your fighter and mine locations and all your notes.
  1342.  
  1343.     A stripped database will include information from the View Game Status
  1344.   except for the Stats Date, you may not want them to know when you were
  1345.   on-line.  All sector warps will be included along with explored/unexplored
  1346.   flags as they are necessary for TWASSIST to determine how to merge the
  1347.   data.  The only port information included is the port class.  The busted
  1348.   dates may be optionally included in case you are trading busted locations.
  1349.   For notes you can specify to include all notes, none of the notes, or
  1350.   individually specify each note.
  1351.  
  1352.     After specifying the optional information to be included, select (C)reate
  1353.   stripped database.  You will be prompted for the filename.  At this time
  1354.   the information will be prepared as specified and you will be prompted for
  1355.   the notes if you wanted to specify each note individually.  The stripped
  1356.   database will then be saved to the file.
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.                                   Page 23
  1380.  
  1381.  
  1382. ╔════════════════════════════════════════════════════════════════════════════╗
  1383. ║ Section  6                  (D)atabase summary                             ║
  1384. ╚════════════════════════════════════════════════════════════════════════════╝
  1385.  
  1386.     This report provides a one screen summary of the database.  At a glance
  1387.   you can see how much you know of the universe, what info the database
  1388.   contains, and how the database flags are set.
  1389.  
  1390.     If you have manually entered warp information on a sector, merged
  1391.   another trader's database, or gathered warp information by processing
  1392.   routes, you may see a number next to the unexplored sector count indicating
  1393.   how many have warps (see (S)ector Reports).  If you add up this number with
  1394.   warps and the explored sector count, the total is the number of sectors you
  1395.   have warp information on.  These are the sectors that routes and distances
  1396.   can be plotted through.
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.                                   Page 24
  1440.  
  1441.  
  1442. ╔════════════════════════════════════════════════════════════════════════════╗
  1443. ║ Section  7                       (N)otes                                   ║
  1444. ╚════════════════════════════════════════════════════════════════════════════╝
  1445.  
  1446.  
  1447. ░▒▓█  7.1  █▓▒░  (V)iew notes
  1448.  
  1449.     The (V)iew notes report will display all notes in the database.  The
  1450.   sector number and the note will be displayed.
  1451.  
  1452.  
  1453. ░▒▓█  7.2  █▓▒░  (E)dit notes
  1454.  
  1455.     The (E)dit notes functions is the same as the (N)otes function in the
  1456.   Modify Database menu.  Refer to that section for information.
  1457.  
  1458.  
  1459. ░▒▓█  7.3  █▓▒░  (S)earch notes   <Registered only>
  1460.  
  1461.     The (S)earch notes report allows you to specify a string of text, and all
  1462.   notes containing that string will be displayed.  You will be prompted for a
  1463.   search string.  The search is case insensitive (so 'a' matches 'a' or 'A').
  1464.   After entering the string, the database will be searched for notes that
  1465.   contain the string.  The sector numbers and notes will be displayed, with
  1466.   the matching string highlighted so you can see where the match was made.
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.                                   Page 25
  1500.  
  1501.  
  1502. ╔════════════════════════════════════════════════════════════════════════════╗
  1503. ║ Section  8                   (A)sset Reports                               ║
  1504. ╚════════════════════════════════════════════════════════════════════════════╝
  1505.  
  1506.  
  1507. ░▒▓█  8.1  █▓▒░  (F)ighter deployments
  1508.  
  1509.     The (F)ighter deployments report will show a list of sectors where you
  1510.   have deployed fighters.  The number of fighters and their mode will be
  1511.   shown along with the sector flags and port type (if any).
  1512.  
  1513.  
  1514. ░▒▓█  8.2  █▓▒░  (M)ine deployments
  1515.  
  1516.     The (M)ine deployments report will show a list of sectors where you have
  1517.   deployed mines.  The number of mines will be shown along with the sector
  1518.   flags and port type (if any).
  1519.  
  1520.  
  1521. ░▒▓█  8.3  █▓▒░  (L)impet deployments
  1522.  
  1523.     The (L)impet deployments report will show a list of sectors where you
  1524.   have deployed Limpet mines.  The number of Limpets will be shown along with
  1525.   the sector flags and port type (if any).
  1526.  
  1527.  
  1528. ░▒▓█  8.4  █▓▒░  (A)ctive Limpets
  1529.  
  1530.     The (A)ctive Limpets report will show a list of sectors where you have
  1531.   Limpets that have been activated.  The number of activated Limpets will be
  1532.   shown along with the sector flags and port type (if any).
  1533.  
  1534.     Each activated Limpet is attached to a ship.  The active Limpet report
  1535.   in the game simply shows a sector number for each activated Limpet.  The
  1536.   numbers may be in any order depending on the order the game is scanning
  1537.   the ship records.  Here you can easily see how many are in each sector.
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.                                   Page 26
  1560.  
  1561.  
  1562. ╔════════════════════════════════════════════════════════════════════════════╗
  1563. ║ Section  9                    (P)ort Reports                               ║
  1564. ╚════════════════════════════════════════════════════════════════════════════╝
  1565.  
  1566.  
  1567. ░▒▓█  9.1  █▓▒░  (P)aired ports
  1568.  
  1569.     The (P)aired ports report will determine where adjacent ports exist that
  1570.   have complimentary buys and sells of products.  These are good locations
  1571.   for trading since you can move back and forth between these ports with a
  1572.   minimum of turns and therefore can do more trades.  Ports with higher
  1573.   quantities to buy/sell give better prices and you can spend more turns
  1574.   there trading and less turns moving to a new pair.
  1575.  
  1576.     The pairs are divided into types of products they will trade.  Equipment
  1577.   gives the highest amount of profit, organics is second, and fuel is third.
  1578.   You can select from four categories of trades plus an option for both ports
  1579.   buying equipment.  This latter item is not for paired port trading.  Evil
  1580.   players use equipment buying ports for a sell/steal cycle.  The default is
  1581.   trading equipment and organics since this is the most profitable.  If you
  1582.   have not explored much of the universe and only a few of these pairs are
  1583.   found you may want to select another category so you have more pairs to
  1584.   choose from.  Also, if there are lots of trader's draining the ports (they
  1585.   take a while to regenerate) all the equipment and organics pairs may not
  1586.   have much for quantities.  Selecting another category may provide a few
  1587.   good places to trade.
  1588.  
  1589.     You will be prompted for a sector number to calculate distances from.
  1590.   The pairs will be shown with the sector numbers and distance to the pair.
  1591.   If the program is registered and the ship transwarp flag is set (see (S)hip
  1592.   information in the (M)odify Database Menu) transwarp calculations will be
  1593.   made to determine the closest fighter to each paired port.  If there is a
  1594.   benefit to transwarping, information will be displayed showing the number
  1595.   of turns to the pair, the number of hops to the fighter, and the location
  1596.   of the fighter.  A factor that is a relative guide to the credit making
  1597.   potential of trading at the pair is calculated.  It can be used to compare
  1598.   the different pairs.  The factor times 100 is roughly the amount of profit
  1599.   that can be made at the pair (e.g. factor of 965 means a profit potential
  1600.   of roughly 96,500 credits).  Due to variations within the game an exact
  1601.   number can not be calculated.  If any of the ports in the pair have unknown
  1602.   product status (see (U)known status ports in (P)ort Reports) the factor will
  1603.   be zero.  Quantities of the products at each of the ports is also shown.
  1604.   The output is sorted by distance to the pair.  If transwarp calculations are
  1605.   made and the transwarp turns is less than the distance, it will be used for
  1606.   the sort.  In this case you may see pairs with a higher distance mixed in
  1607.   with pairs of lower distance because of the lower number of transwarp turns.
  1608.  
  1609.  
  1610. ░▒▓█  9.2  █▓▒░  (N)earest ports
  1611.  
  1612.     The (N)earest ports report will show the locations of all ports, sorted by
  1613.   distance from the reference sector.  The report will be like the (N)earest
  1614.   sectors report in (S)ector Reports except only sectors with ports will be
  1615.   shown.
  1616.  
  1617.  
  1618.  
  1619.                                   Page 27
  1620.  
  1621.  
  1622. ░▒▓█  9.3  █▓▒░  (U)known status ports
  1623.  
  1624.     Unknown status ports are ports where you do not have updated information
  1625.   on the amount of the products available from the CIM port report.  This can
  1626.   be caused by three things:
  1627.  
  1628.       (1)  You have not explored the sector.  You may have manually entered
  1629.            the port class based on information from another trader or it was
  1630.            merged in from another traders database.  You will see the
  1631.            unexplored sector flag for these ports.
  1632.  
  1633.       (2)  There are deployed fighters in the sector, either the Ferrengi or
  1634.            another player.  You can get port status through your own personal
  1635.            or corporate fighters but not through other fighters.
  1636.  
  1637.       (3)  The port has been destroyed.  In this case you should remove the
  1638.            port from the database.
  1639.  
  1640.     The output of this report will look like the (N)earest ports report except
  1641.   only ports with unknown status will be shown.
  1642.  
  1643.  
  1644. ░▒▓█  9.4  █▓▒░  (B)usted ports
  1645.  
  1646.     The (B)usted ports report will display the ports that have busted dates
  1647.   set.  If the maintenance cycle is known (from information extract from a
  1648.   View Game Status report) the dates port records were last cleared of busted
  1649.   names and the date they will be cleared next will be displayed.  A list of
  1650.   sector numbers, port types, and the dated busted will be shown.
  1651.  
  1652.     Each time you enter the program the date will be checked to see if it is
  1653.   after the next clear date.  If it is, all busted port dates up to but not
  1654.   including the clear date will be cleared from the database and the database
  1655.   modified flag will be set. The program plays it safe with regard to clearing
  1656.   the busted dates.  They are not cleared on the actual clear date because you
  1657.   may be playing before the game's maintenance is run.  When they are cleared
  1658.   on the next day the busted dates on the last clear date on not cleared
  1659.   because you may have played after maintenance.  It is better to be on the
  1660.   safe side than to go to a port you were busted at.  If you play after
  1661.   maintenance on the clear date you can always ignore the busted flags.  If
  1662.   you play before maintenance on the clear date, you can always delete those
  1663.   busted dates manually.  You can tell when maintenance is run by examining
  1664.   the daily log in the game.  The line that says the "Ferrengi moved at" is
  1665.   when the maintenance was run.
  1666.  
  1667.  
  1668. ░▒▓█  9.5  █▓▒░  (0) Closest place to buy class 0 items
  1669.  
  1670.     This report will give a tabular display of the class 0 ports and their
  1671.   distances.  The stardock will also be included if the information in the
  1672.   game status (TW2002 version and registration status) indicate the shipyards
  1673.   are open.  If the program is registered and the ship transwarp flag set,
  1674.   additional columns will show the nearest fighter, turns, and hops to
  1675.   transwarp to each of these ports.
  1676.  
  1677.  
  1678.  
  1679.                                   Page 28
  1680.  
  1681.  
  1682. ░▒▓█  9.6  █▓▒░  (L)ikely major port locations
  1683.  
  1684.   NOTE:  TW2002 v1.03(d) and v2 have different characteristics for the
  1685.          sectors the major ports are located in.  TWAssist will use the
  1686.          game version to determine which set of characteristics to look
  1687.          for.  Check the Database Summary screen to verify the game
  1688.          version is properly indicated in the database.
  1689.  
  1690.     This report will show the sectors that are likely locations for the
  1691.   Stardock and class 0 ports.  The sectors for these major ports are
  1692.   characterized by having lots of warps, typically all 6, with a number of
  1693.   them being one ways.  This is a good companion to the (M)ap universe
  1694.   routes (see Route Reports).  After using the routes to gather information
  1695.   on the warps of the universe then use this report to find the likely
  1696.   locations for the Stardock and class 0 ports.  You will need to map enough
  1697.   of the universe to get most of the warps to get good candidates for major
  1698.   port locations.  If you don't map enough you will have a long list since
  1699.   the information is not accurate enough.
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.                                   Page 29
  1740.  
  1741.  
  1742. ╔════════════════════════════════════════════════════════════════════════════╗
  1743. ║ Section  10                  (S)ector Reports                              ║
  1744. ╚════════════════════════════════════════════════════════════════════════════╝
  1745.  
  1746.     TWASSIST categorizes sectors a number of ways.  Like TW2002, there are
  1747.   explored and unexplored sectors.  TWASSIST further divides the unexplored
  1748.   sectors into other categories.  Some of the following descriptions for the
  1749.   sector reports will use the diagram below for an example to aid in
  1750.   explaining the different categories.
  1751.  
  1752.             100 <────> 200 <────> 300 <────> 400 <────> 500
  1753.           player 1                                    player 2
  1754.  
  1755.           Player 1 has explored sector 100 but not the others.
  1756.           Player 2 has explored sector 500 but not the others.
  1757.  
  1758.  
  1759. ░▒▓█  10.1  █▓▒░  (F)ull report on a sector
  1760.  
  1761.     The (F)ull report on a sector gives a detailed display of all the
  1762.   information known about a sector.  Included will be the warps with one
  1763.   ways out identified, back doors, flag settings, various parameters, port
  1764.   information, and any note.
  1765.  
  1766.  
  1767. ░▒▓█  10.2  █▓▒░  (N)earest sectors
  1768.  
  1769.     The (N)earest sectors report will show each sector, sorted by distance
  1770.   from the current sector.  The report will show the sector number, the
  1771.   distance to the sector, and the flags for that sector.  If the sector has a
  1772.   port it will also show the port type and the product status.  Any note for
  1773.   the sector will also be shown.
  1774.  
  1775.  
  1776. ░▒▓█  10.3  █▓▒░  (U)nexplored sectors
  1777.  
  1778.     The (U)nexplored sectors report is the same as the (N)earest sectors
  1779.   report except it only shows those sectors that are unexplored.  This can be
  1780.   used to find a close sector to explore.  Maybe you have a few extra turns
  1781.   left after trading.
  1782.  
  1783.     If you merge databases with another trader, this is the last report to
  1784.   use to find sectors to explore.  Once you have information on the entire
  1785.   universe there will be no need to continue to merge databases but you may
  1786.   have some sectors you have not personally explored and can not get port
  1787.   information on.  To get the most use out of an ether probe, send it to a
  1788.   dead end sector some distance away.  Choose the dead ends closer to the end
  1789.   of the report.  By sending the probe some distance away you have a greater
  1790.   chance of going through more unexplored sectors.  You also want to explore
  1791.   the entire tunnel with one probe instead of stopping part way in and needing
  1792.   another probe later to get the rest.  After getting the dead ends, work on
  1793.   the rest of the sectors.
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.                                   Page 30
  1800.  
  1801.  
  1802. ░▒▓█  10.4  █▓▒░  Une(x)plored clusters   <Registered only>
  1803.  
  1804.     The Une(x)plored clusters report can tell you where you have groups of
  1805.   unexplored sectors.  The report will show each sector number that has
  1806.   adjacent unexplored sectors and the number of unexplored sectors.  It will
  1807.   also show the number of those unexplored sectors that have no warp informa-
  1808.   tion (see (W)ithout warps in Sector Reports).  The report is sorted by the
  1809.   number of adjacent unexplored sectors in descending order.  The sector with
  1810.   the most adjacent unknown information is at the top.
  1811.  
  1812.     These unexplored clusters are a good place to do a holoscan since one turn
  1813.   with the holoscanner can explore a number of sectors.  This is especially
  1814.   useful if the sector has a good port that could be part of a trade pair.  If
  1815.   a sector has a port that is buying organics and selling equipment or vice
  1816.   versa, and has a number of unexplored sectors adjacent, there is a good
  1817.   chance you may find a matching port.
  1818.  
  1819.  
  1820. ░▒▓█  10.5  █▓▒░  Un(k)nown sectors   <Registered only>
  1821.  
  1822.     The Un(k)nown sector report is not the same as the unexplored sector
  1823.   report from the computer in the game.  This unknown sector report will show
  1824.   sectors which have no location information in the database.  They have no
  1825.   known warps and no other sector has a warp to them.  In the above diagram,
  1826.   player 1 would show sectors 300, 400, and 500 as unknown.  Sector 200 is not
  1827.   considered unknown because sector 100 has a warp to it.  For player 2, the
  1828.   unknown sectors are 100, 200, and 300.  If the two players merged their
  1829.   databases, both players would have warp information for sectors 100 and 500,
  1830.   and sectors 200 and 400 have warps to them.  The only unknown sector is 300.
  1831.  
  1832.     This is useful for sending ether probes. If you used the unexplored sector
  1833.   report from the game computer you could pick sectors that are adjacent to
  1834.   explored sectors, especially after you have explored a good portion of the
  1835.   universe.  By using this unknown sector report you know the probe has to go
  1836.   through at least one other unexplored sector to get to it.  You are more
  1837.   likely to get multiple unexplored sectors in the path so the ether probe
  1838.   provides more information.  Use the computer on-line in the game to go plot
  1839.   paths (F command) to these unknown sectors and pick ones that have more
  1840.   unexplored sectors in the paths as the ether probe target.
  1841.  
  1842.     If you are merging databases with another trader you can use this report
  1843.   to maximize your explorations/probes.  These sectors are unknown to both
  1844.   traders so you can get the most benefit from exploring these sectors.
  1845.  
  1846.   NOTE:  Since there is no CIM output for determining the location of the
  1847.          class 0 ports you should be on the lookout for their locations in
  1848.          the probe outputs.  Make use of your scroll back buffer or capture
  1849.          the entire session and review it later off-line.
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.                                   Page 31
  1860.  
  1861.  
  1862. ░▒▓█  10.6  █▓▒░  (W)ithout warps   <Registered only>
  1863.  
  1864.     The (W)ithout warps reports is similar to the (U)nexplored sectors report
  1865.   except it shows only those sectors that have no warp information.  For those
  1866.   who have never modified the database to add warps for a sector and never
  1867.   merged databases from another trader, then this report will be just like the
  1868.   unexplored sector report.
  1869.  
  1870.     In the above example diagram, player 1 has four unexplored sectors.  If
  1871.   player 1 merged databases from player 2 then sector 500 would have warp
  1872.   information even though it is unexplored.  The (W)ithout warps report will
  1873.   only report sectors 200, 300, and 400.
  1874.  
  1875.     This is useful when merging databases and you are getting towards the end
  1876.   of exploring the universe.  Once you have explored the universe to eliminate
  1877.   the unknown sectors, you may still have sectors where you do not have warp
  1878.   information.  In the above diagram, let's say player 1 wants to explore
  1879.   unknown sector 300, so a probe is sent from 100 through 200 to 300.  With
  1880.   the data for sector 500 from player 2, that leaves only sector 400 without
  1881.   warp information.  This is a sector that is unexplored by both players.
  1882.  
  1883.  
  1884. ░▒▓█  10.7  █▓▒░  (D)ead end sector analysis
  1885.  
  1886.     The (D)ead end sectors analysis shows the tunnels out of a dead end
  1887.   sector.  A dead end sector is one that has only one sector that leads to it
  1888.   and it's only way out is to that same sector.  This report shows the depths
  1889.   of the tunnels of dead ends in the universe and how many at each depth.
  1890.   You may then select a desired depth for more information on those sectors.
  1891.   The report will display the sector number and port type (if any) for each
  1892.   dead end of this depth.  Each sector in the tunnel will be shown in the
  1893.   same way until the entrance/exit of the tunnel is reached.
  1894.  
  1895.     You can not go through a dead end sector on the way to somewhere.  You can
  1896.   only get to it by setting it as the destination.  If the sector has multiple
  1897.   ways out or a way out that is not the same as the only way in, then it is
  1898.   possible to pass through the sector while going some place else and is
  1899.   therefore not classified as a dead end.  As a result, dead end sectors are
  1900.   not as easily explored.  This is usually a good place for building planets
  1901.   and hiding when you don't have a cloak.  A deeper tunnel is less likely to
  1902.   get explored and provides more room for defenses.  It also gives your
  1903.   opponents more room for blocking you in and takes more turns to get in and
  1904.   out each time unless you have a transwarp.
  1905.  
  1906.  
  1907. ░▒▓█  10.8  █▓▒░  DE distances to (M)ajor ports  <Registered only>
  1908.  
  1909.     The DE distances to (M)ajor ports will show a table of distances to and
  1910.   from each of the major ports (Sol/Terra, Stardock, and the other two class
  1911.   0 ports).  The table will be sorted with the deepest dead ends first and
  1912.   then sorted by distance to Sol/Terra.
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.                                   Page 32
  1920.  
  1921.  
  1922. ░▒▓█  10.9  █▓▒░  A(v)oids
  1923.  
  1924.     The A(v)oids report comes in two formats.  One is the standard report
  1925.   showing the avoided sectors with their flags, port info, etc.  The
  1926.   other report is just a list of sector numbers with one avoided sector
  1927.   per line.
  1928.  
  1929.     The list of sectors is useful for integration with communications
  1930.   program macros using TWASSIST Automode.  After capturing the avoided
  1931.   sectors information from the game (possibly along with other report) and
  1932.   having TWASSIST extract the information from the capture you can have
  1933.   TWASSIST create a file using Automode that lists the avoided sectors.
  1934.   The comm. program macro could then clear out the avoids in the game.
  1935.   One purpose would be to plot routes like the no-turn universe mapper.
  1936.   At the end of the macro it could again use the list of avoids to
  1937.   restore them in the game.
  1938.  
  1939.  
  1940. ░▒▓█  10.10  █▓▒░  (C)luster dead end analysis   <Registered only>
  1941.  
  1942.     The (C)luster dead end analysis will look for a sector that has no back
  1943.   doors and all but one warp leads to a dead end.  The one warp is the
  1944.   entrance/exit to the cluster.  To find these groups it is necessary to
  1945.   explore all those DE1s that most people do not worry about.  For example,
  1946.   consider the following layout of sectors (all two way warps):
  1947.  
  1948.                                    500
  1949.                                     │
  1950.                      100 ── 200 ── 300 ── 400 entrance/exit
  1951.                                     │
  1952.                                    600
  1953.  
  1954.     If sector 500 or 600 is unexplored you can not tell if this is a dead end
  1955.   cluster.  After exploring 40% or more of the universe, use the unexplored
  1956.   clusters report and holoscan.  You will find a number of them are dead ends
  1957.   one deep and may be part of a dead end cluster.  In the above example with
  1958.   all the sectors explored, sector 300 will be detected as being a dead end
  1959.   cluster.  You may even find a sector that has 4 DE1s with a single way in
  1960.   and out.
  1961.  
  1962.     Dead end clusters may be a good place to build.  This will depend on your
  1963.   competition and how they search for other players planets (and whether or
  1964.   not they are using a utility like this one).  You may have the benefit of a
  1965.   number of close ports and still have a defendable location.  You will also
  1966.   find dead ends that are a lot deeper than anyone may think they are.  I have
  1967.   seen a dead end cluster with a dead end 3 deep and the entrance/exit to the
  1968.   cluster was also 3 deep.  That means the dead end was really 6 sectors from
  1969.   a through way.
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.                                   Page 33
  1980.  
  1981.  
  1982.  
  1983. ░▒▓█  10.11  █▓▒░  (S)ecluded area analysis   <Registered only>
  1984.  
  1985.     The (S)ecluded area analysis will search for areas that are secluded from
  1986.   the main routes in the universe.  These areas are like large dead ends with
  1987.   a single sector as the entrance and exit for the entire area.  Areas that
  1988.   are already reported as dead ends or dead end clusters will not be included.
  1989.   It can report areas that include multiple dead end clusters, a number of
  1990.   dead ends not picked up as clusters, loops of sectors, etc.  There is a lot
  1991.   of analysis to do and it can take a long time to run.
  1992.  
  1993.     Each secluded area will have its own uniqueness for building planets.
  1994.   They can tell you that dead end or dead end cluster inside is more secluded
  1995.   than the others, and loops of non-dead end secluded sectors won't show up
  1996.   on the typical dead end reports most players use.
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.                                   Page 34
  2040.  
  2041.  
  2042. ╔════════════════════════════════════════════════════════════════════════════╗
  2043. ║ Section  11                  (R)oute Reports                               ║
  2044. ╚════════════════════════════════════════════════════════════════════════════╝
  2045.  
  2046.  
  2047.   NOTE:  TW2002 v1.03(d) and v2 use slightly different route algorithms.  If
  2048.          multiple routes of the same number of warps are found the two
  2049.          versions may report different routes.  TWAssist takes the game
  2050.          version into consideration when determining the route.  Check the
  2051.          Database Summary screen to verify the game version is properly
  2052.          indicated in the database.
  2053.  
  2054.  
  2055. ░▒▓█  11.1  █▓▒░  (N)ormal route
  2056.  
  2057.     The (N)ormal route report will determine the distance to a destination
  2058.   and the sectors travelled through.  The first sector listed will be the
  2059.   starting location and the last sector listed will be the destination.  Each
  2060.   sector will be shown in the order they are travelled through to reach the
  2061.   destination.  The output format will be like the (N)earest sectors report
  2062.   in the Sector Reports menu.  At the end of the list the distance will be
  2063.   given.  You will then be prompted on whether or not you want to display the
  2064.   return path.
  2065.  
  2066.  
  2067. ░▒▓█  11.2  █▓▒░  (T)ranswarp route
  2068.  
  2069.     The (T)ranswarp route report is similar to the normal route report except
  2070.   it will look at fighter locations and determine if fewer turns could be used
  2071.   by transwarping.  If transwarping takes fewer turns it will display the
  2072.   route with the first sector the starting location, the second sector the
  2073.   fighter to transwarp to, followed by the sectors travelled through from the
  2074.   fighter, and the last sector will be the destination.  At the end of the
  2075.   list the turns, hops, and fighter location will be given.  If there is no
  2076.   benefit to transwarping a message will say so and a route using normal
  2077.   movement will be shown.
  2078.  
  2079.  
  2080. ░▒▓█  11.3  █▓▒░  (S)pace lanes
  2081.   
  2082.     The (S)pace lanes report will determine the routes for each of the eight
  2083.   space lanes.  These are the routes the Feds will clear all fighters and
  2084.   mines from during maintenance.  The following diagram shows what the space
  2085.   lanes are:
  2086.  
  2087.        ┌─────────┐        
  2088.        │    1    │        ┌────────────────┐
  2089.        │   Sol   ├────────┤ Stargate Alpha ├───────────────────┐
  2090.        │ Class 0 ├────────┤    Stardock    ├────────────────┐  │
  2091.        └─────────┘        └──────┬──┬──────┘                │  │
  2092.                                  │  │                       │  │
  2093.                                  │  │                       │  │
  2094.                           ┌──────┴──┴──────┐          ┌─────┴──┴───────┐
  2095.                           │ Alpha Centauri ├──────────┤     Rylos      │
  2096.                           │    Class 0     ├──────────┤    Class 0     │
  2097.                           └────────────────┘          └────────────────┘
  2098.  
  2099.                                   Page 35
  2100.  
  2101.  
  2102.                         11.3  (S)pace lanes  (cont'd)
  2103.  
  2104.  
  2105.     The (S)pace lanes report has output in two parts.  First are the actual
  2106.   routes.  On the left of the screen is the starting location of each of the
  2107.   routes, and on the right is the final location.  In between, the sectors on
  2108.   the route are listed.  The second part of the output is a listing of the
  2109.   sectors in all the space lanes listed in numerical order.  The provides an
  2110.   easy method of determining if a sector is in a space lane.
  2111.  
  2112.     TWASSIST can only calculate the space lanes based on the information you
  2113.   have about the universe.  If you do not have the actual paths explored, the
  2114.   routes calculated may not be the same as in the game.  Use the computer in
  2115.   the game to show each route (without any avoids but save them so you can
  2116.   reenter them) and capture those routes.  TWASSIST can read those routes and
  2117.   update the warp info so it can calculate the same space lanes the game does.
  2118.  
  2119.  
  2120. ░▒▓█  11.4  █▓▒░  (M)ap universe routes
  2121.  
  2122.   NOTE:  This routine saves information about the internal calculations in
  2123.          the database.  This allows the program to take advantage of some
  2124.          previously calculated data from previous runs.  Using this feature
  2125.          will set the database modified flag and you will be prompted to
  2126.          save the database when you exit the program or use one of the
  2127.          menus that normally modifies the database.
  2128.  
  2129.     (M)ap universe routes will analyze the warp information in the database
  2130.   and determine sectors for doing course plots which can be extracted from
  2131.   the capture file to build warp information for the sectors.  A file named
  2132.   game.CIM (where game is the database name) will be created with commands to
  2133.   be sent to TW2002 at the CIM prompt for plotting the routes.  A macro for
  2134.   your communications program or some other method of pacing the commands to
  2135.   the game's prompts is required.  The game will lose characters that are
  2136.   sent while it is processing something.  Although you can get some course
  2137.   plots if you ASCII upload the game.CIM file you will get a lot of errors
  2138.   about an invalid interrogation mode command.  If you don't have a macro
  2139.   and know a little bit about writing them take a look at the macros provided
  2140.   and see if you can develop one for your own communications program.  If all
  2141.   else fails you can manually enter the routes yourself.  It will take longer,
  2142.   and you will probably spread it out over more than one day, it is better
  2143.   than nothing.
  2144.  
  2145.     You can specify the approximate number of routes to be prepared.  The
  2146.   actual number will vary.  As TWASSIST enters each level of analysis it will
  2147.   make a decision on whether or not to continue based on how many routes are
  2148.   already in the file, the number specified, and the type of analysis to be
  2149.   done next.  The number specified is a trade off between the number of times
  2150.   going in and out of TWASSIST and the amount of time spent on-line plotting
  2151.   the courses in TW2002.  If the number is too small you spend a lot of time
  2152.   cycling in and out of TWASSIST for just a little more information.  If the
  2153.   number is too big you spend a lot of on-line time before TWASSIST has a
  2154.   chance to analyze the new information.  For a 1000 sector universe numbers
  2155.   in the 200 range seem to be the most efficient, at 2400 baud or 14.4k baud.
  2156.   Lower speed callers will want to tend to the lower end (e.g. 200, 225) while
  2157.  
  2158.  
  2159.                                   Page 36
  2160.  
  2161.  
  2162.                     11.4  (M)ap universe routes  (cont'd)
  2163.  
  2164.  
  2165.   higher speed callers may want to use slightly larger numbers.  Speed tests
  2166.   have not yet been conducted in larger universes.  Lower speed callers may
  2167.   want to increase the number slightly but not too much or the on-line time
  2168.   for each cycle will get too large.  High speed callers have more
  2169.   flexibility in using larger numbers without the on-line time getting too
  2170.   large.
  2171.  
  2172.     To complete the mapping of the universe the cycle must be repeated.  The
  2173.   (A)nalyze warps routine (see the section below) can be used to help
  2174.   determine how much information you have gathered and how close you are to
  2175.   completing the mapping.  A few numbers of interest are the number of new
  2176.   route warps from last extract and the number of likely locations for major
  2177.   ports.  After a cycle in a new universe the number of new route warps will
  2178.   usually be in the hundreds.  After each cycle the number will drop rapidly.
  2179.   When the number gets below a hundred you have most of the warp information
  2180.  
  2181.   and continuing beyond this may not provide much information (although you
  2182.   may want to until the number is less than 10 if you have the time).  The
  2183.   likely locations for major ports is another key number.  In a typical
  2184.   TW2002 v1.03(d) universe the number can get down to 3 or 4.  Part way
  2185.   through the mapping this number will be very large since TWASSIST does not
  2186.   have enough information to narrow down the possibilities.  You want to
  2187.   continue mapping until this number is small so you have few places to check
  2188.   to find these ports.
  2189.  
  2190.     This mapping method is not 100% accurate.  The only way to get 100% would
  2191.   take a lot of time.  The method used by TWASSIST was developed to gather as
  2192.   much information as possible in a reasonable amount of time (and appears to
  2193.   be more efficient than the variations on level diagrams used by other
  2194.   utils).  Most of the warps are picked up in the early cycles with the later
  2195.   cycles picking up less.  How much time you want to spend gathering warps
  2196.   depends on you and your time allowed in the game.  You can do a little
  2197.   mapping each day.  Each time TWASSIST will figure out how to integrate the
  2198.   new data with the existing data in the database.
  2199.  
  2200.     Once you know the warps of the universe TWASSIST can calculate routes
  2201.   through unexplored sectors just like in the game.  You can also figure out
  2202.   where all the dead ends and other structures of interest are located.  No
  2203.   need to spend time trying to find a good dead end or whatever to build
  2204.   planets, or even where your competition may be building! <g>  You can also
  2205.   easily locate the Stardock, if not in the View Game Status, and the class 0
  2206.   ports.  This information can put you days ahead of your competition if they
  2207.   are not using some mapper.  You can also make your Etherprobing more
  2208.   efficient.  You know where the dead ends are so you can send the probe all
  2209.   the way in instead of just guessing and having the probe end up in the
  2210.   tunnel only to have to send more later to get the rest.  This mapping method
  2211.   does not actually explore all the sectors and you will not have port
  2212.   information.  You will still have to explore to find the ports but once you
  2213.   get started you can use Etherprobes to find them and that is better than
  2214.   using your turns for this purpose.
  2215.  
  2216.  
  2217.  
  2218.  
  2219.                                   Page 37
  2220.  
  2221.  
  2222. ░▒▓█  11.5  █▓▒░  (A)nalyze warps
  2223.  
  2224.     The (A)nalyze warps report will give you summary information about the
  2225.   known warps in the universe.  It is a very useful companion to the (M)ap
  2226.   universe routes feature above.  The total number of warps is a count of
  2227.   all warps in all the sectors.  This number is also divided by the number of
  2228.   sectors in the universe to get the average number of warps per sector.  In
  2229.   TW2002 v1.03(d) games the average is around 2.41.  The number of duplicate
  2230.   warps is a count of warps when a sector has the same warp more than once.
  2231.   Each repeated warp is counted as a duplicate warp.  The number if
  2232.   inaccessible sectors is a count of the number of sectors that do not have
  2233.   any warps in.  Once you have mapped the universe this is the number of
  2234.   orphans in the universe.  Prior to complete mapping it will indicate the
  2235.   number of warps TWASSIST can not plot routes to.  The number of inaccessible
  2236.   warps is the count of the warps the inaccessible sectors have.  Orphans
  2237.   typically have warps out, which may have been picked up by the mapper, but
  2238.   no warps in.  The next two items are very useful for determining how close
  2239.   you are to completing the mapping of the universe.  The new route warps from
  2240.   last extract is a count of the number of new warps added to the database
  2241.   that were extracted from course plots the last time an extract from a
  2242.   capture file was done.  The likely locations for major ports is the count of
  2243.   the number of sectors the (L)ikely locations for major ports report in the
  2244.   port reports menu would show.
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.                                   Page 38
  2280.  
  2281.  
  2282. ╔════════════════════════════════════════════════════════════════════════════╗
  2283. ║ Section  12        (C)ustom Reports   <Registered only>                    ║
  2284. ╚════════════════════════════════════════════════════════════════════════════╝
  2285.  
  2286.     The entire custom reports menu is registered only.
  2287.  
  2288.     The (C)ustom reports provides a flexible way of defining your own reports.
  2289.   You can select the type of report:  paired ports, single ports, or any
  2290.   sector.  For each report you can specify various parameters that must be met
  2291.   for the pair/port/sector to be matched and shown in the report.  You can
  2292.   also specify various ways of sorting the output.  Up to 6 reports can be
  2293.   defined, with a title for each.  The custom reports are stored in a file
  2294.   with the same name as the datafile but with a .CUS extension.  This allows
  2295.   you to create different reports for each game for the style of play you are
  2296.   using for that game.  Here are some things custom reports have been used
  2297.   for:
  2298.  
  2299.       * Finding the competition's transwarped planet.
  2300.       * Checking for deployed fighters and mines in space lanes.
  2301.       * Finding a good and unique home sector.
  2302.       * Finding pairs of ports with good trading potential.
  2303.       * Finding good ports for stealing products or robbing credits.
  2304.  
  2305.     When you enter the custom reports you will be shown a list of your
  2306.   reports.  You will also see a menu of selections for working with the
  2307.   reports.  If no reports are defined, only the menu items that would define
  2308.   a report will be shown.  If at least one report is defined, additional menu
  2309.   selections will be shown.  When you quit the custom reports menu the
  2310.   program will check to see if there are modifications to the reports that
  2311.   have not been saved to the file.  You will be prompted if you want to save
  2312.   the reports to the file.  If you say no you will be asked again when you
  2313.   exit the program just to make sure.
  2314.  
  2315.  
  2316. ░▒▓█  12.1  █▓▒░  (C)opy a report  <Registered only>
  2317.  
  2318.     The (C)opy a report function provides a way of quickly copying the report
  2319.   parameters from one to another.  This is useful if you want to test out
  2320.   some changes without disturbing the original report or if you want to create
  2321.   a similar report with a few parameter changes.  You will be shown a list of
  2322.   the reports and asked to specify the report number of the source to be
  2323.   copied and then the report number of the destination.  If the destination
  2324.   report has been defined, a message will be displayed asking you to verify
  2325.   you want to replace it.  All the report parameters including the title will
  2326.   be copied.  The title can be changed by modifying the report.
  2327.  
  2328.  
  2329. ░▒▓█  12.2  █▓▒░  (D)isplay a report  <Registered only>
  2330.  
  2331.     The (D)isplay a report function will provide a screen of information
  2332.   showing all the parameters for a report.  You will be shown a list of the
  2333.   reports and asked to select the report number to display.
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.                                   Page 39
  2340.  
  2341.  
  2342. ░▒▓█  12.3  █▓▒░  (E)xecute a report  <Registered only>
  2343.  
  2344.     Once you have reports defined, the (E)xecute a report function will
  2345.   perform the report and display the output.  Various TWASSIST functions will
  2346.   be called to search the database for pairs/ports/sectors that match the
  2347.   parameters of a report.  You will be shown a list of reports and asked to
  2348.   select the report number to execute.
  2349.  
  2350.     If the ship transwarp flag is set to yes and the report specifies to
  2351.   consider transwarp in maximum turns, transwarp calculations will be made
  2352.   for all matches.  Transwarp information will then be included in the report
  2353.   output.
  2354.  
  2355.  
  2356. ░▒▓█  12.4  █▓▒░  (M)odify a report  <Registered only>
  2357.  
  2358.     The (M)odify a report function will allow you to define parameters for a
  2359.   new report or change parameters in a defined report.  You will be shown a
  2360.   list of the reports and asked to select the report number to modify.  When
  2361.   modifying a report, defaults for the parameters will be the same as
  2362.   currently defined in the report.  You can select the defaults and just
  2363.   change the items you want to.  This makes it easy to vary just a parameter
  2364.   or two to see the affects or to fine tune the report.
  2365.  
  2366.     First you will be asked to specify the type of report.  A paired port
  2367.   report will be like the report in the port reports menu, a single port
  2368.   report will be like the nearests ports report, and a sector report will be
  2369.   like the nearest sectors report.  Once the type of report is selected, you
  2370.   will be asked to specify the parameters of the report.  Some of them are
  2371.   common to all the reports and some are for only one type of report.  You
  2372.   will be asked for only the parameters that apply to the type of report
  2373.   selected.  Prompts for the parameters describe what the parameter does and
  2374.   some parameters have information that provides more detail about it.  After
  2375.   specifying all the parameters you will be asked for a title for the report.
  2376.   This is the title that will show up in the listing of the reports and in
  2377.   the report file if the output of a report is sent to a file.
  2378.  
  2379.  
  2380. ░▒▓█  12.5  █▓▒░  (R)ead reports from another file  <Registered only>
  2381.  
  2382.     The (R)ead reports from another file function is a way to merge reports
  2383.   in separate files.  You can use it to read reports you have developed for
  2384.   another game or you can use it to read reports from another trader.  You
  2385.   will be prompted for the filename of the custom  report file to read.
  2386.   After reading the file you will be shown a list of the reports from the
  2387.   file.  Select the report you are interested in.  The report parameters will
  2388.   be displayed so you can review the report.  You will be asked if you want
  2389.   to copy this report.  If you decide to copy the report, you will be shown
  2390.   the title of the report and a list of your current reports.  You will be
  2391.   asked to select a destination report number.  If the report number is
  2392.   currently defined you will be asked to very if you want to replace it.  All
  2393.   report parameters including the title will be copied.
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.                                   Page 40
  2400.  
  2401.  
  2402. ╔════════════════════════════════════════════════════════════════════════════╗
  2403. ║ Section  13                 (G)raphic Displays                             ║
  2404. ╚════════════════════════════════════════════════════════════════════════════╝
  2405.  
  2406.     The (G)raphic Displays menu provides selections for viewing the layout of
  2407.   space in graphics.  Symbols are used to show various characteristics of the
  2408.   sectors.  See the (?) Graphic symbols subsection below.  While viewing space
  2409.   in graphics, you can use the question mark (?) to switch to the symbols
  2410.   display.  When you end the symbols display the graphic display of space will
  2411.   be restored.
  2412.  
  2413.     The program will automatically detect the type of graphics interface in
  2414.   your computer.  Refer to the compatibility sector for supported types.
  2415.   Refer to the (V)ideo driver section under ($) Registration and Configuration
  2416.   if the program is having problems detecting your graphics interface.
  2417.  
  2418.     To be able to print the graphics screens on the printer you must have the
  2419.   DOS graphics command loaded into memory.  It allows you to print a graphics
  2420.   display using <SHIFT><Print Scrn>.  Typically it is loaded during boot up
  2421.   by the autoexec.bat file.  Refer to your DOS manual for information on the
  2422.   graphics command and configuring it for your system.
  2423.  
  2424.  
  2425. ░▒▓█  13.1  █▓▒░  Display around a (S)ector
  2426.  
  2427.     Display around a (S)ector will provide a graphical representation of
  2428.   sector positions relative to a sector.  You will be prompted for the
  2429.   reference sector to display the space around.  The program will automati-
  2430.   cally determine the maximum distance that can be reasonably displayed and
  2431.   will display those sectors.  The distance displayed will be shown in the
  2432.   title text at the top of the screen.  The reference sector will be in the
  2433.   middle of the screen and will be highlighted.
  2434.  
  2435.  
  2436. ░▒▓█  13.2  █▓▒░  Display along a (R)oute   <Registered only>
  2437.  
  2438.     Display along a (R)oute will provide a graphical representation of the
  2439.   route to a sector and the scenery (adjacent sectors) passed along the way.
  2440.   You will be prompted for a start sector and a destination sector.  Sectors
  2441.   on the route will be arranged in a line that zig-zags across the screen.
  2442.   The starting sector will be in the upper left.  Sectors adjacent to the
  2443.   route will be shown above and below the route line.  Sectors on the route
  2444.   will be highlighted.
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.                                   Page 41
  2460.  
  2461.  
  2462. ╔════════════════════════════════════════════════════════════════════════════╗
  2463. ║ Section  14         ($) Registration and configuration                     ║
  2464. ╚════════════════════════════════════════════════════════════════════════════╝
  2465.  
  2466.     Registration and configuration information is stored in the configuration
  2467.   file.  Only one file is used.  The file is named TWASSIST.CFG and is located
  2468.   in the same location as the program executable.  This allows the use of
  2469.   multiple directories for storing game information without the need to copy
  2470.   the executable or the configuration file.  The configuration file will be
  2471.   created by the program.  When you quit the registration and configuration
  2472.   menu, the program will check to see if you made changes that have not been
  2473.   saved to the file.  You will then be prompted if you want to save the
  2474.   changes to the file.  If you say no, you will be asked again when you exit
  2475.   the program.
  2476.  
  2477.  
  2478. ░▒▓█  14.1  █▓▒░  Registration (N)ame
  2479.  
  2480.     Enter the registration name exactly as it appears in your registration
  2481.   letter, including punctuation and capitalization.  If the registration name
  2482.   and code are valid, the "Free Version" text at the top of the menu screen
  2483.   will change to "Registered to" and the registration name.
  2484.  
  2485.  
  2486. ░▒▓█  14.2  █▓▒░  Registration (C)ode
  2487.  
  2488.     Enter the registration code exactly as it appears in your registration
  2489.   letter, including punctuation and capitalization.  If the registration name
  2490.   and code are valid, the "Free Version" text at the top of the menu screen
  2491.   will change to "Registered to" and the registration name.
  2492.  
  2493.  
  2494. ░▒▓█  14.3  █▓▒░  (D)ESQview lines
  2495.  
  2496.     The program will detect the maximum height set for the window.  If you
  2497.   use TWASSIST without the window at maximum zoom, or if it appears the
  2498.   program is having a problem correctly detecting the number of lines while
  2499.   under DESQview, you can set the number of lines to use with this menu item.
  2500.   This value has no effect if DESQview is not detected.  If set to auto
  2501.   detect, the number of lines detected will be shown in parenthesis on the
  2502.   menu line.
  2503.  
  2504.     When you select (D)ESQview lines you will be shown the current setting and
  2505.   asked to enter the number of lines to use.  The default will be the current
  2506.   setting.
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.                                   Page 42
  2520.  
  2521.  
  2522. ░▒▓█  14.4  █▓▒░  (H)ot keys
  2523.  
  2524.     Hot keys allow you to make selections for many of the prompts without the
  2525.   need to press 'Enter' to end the input.  For example, when selecting a menu
  2526.   item, with hot keys enabled the function will be immediately executed when
  2527.   the menu character is pressed.  With hot keys disabled the program will wait
  2528.   for 'Enter' to end the input before the function is executed.  With hot keys
  2529.   enabled, fewer key strokes are required to use the program so you can move
  2530.   through it faster.  With hot keys disabled, you have a chance to backspace
  2531.   and change your input.  When prompting for a number (like a sector number),
  2532.   or a string of text (like a note), you will still have to use 'Enter' to end
  2533.   the input independent of the hot keys setting.  Use the setting you are most
  2534.   comfortable with.
  2535.  
  2536.     When you select (H)ot keys you will be asked if you want to change the
  2537.   setting to the opposite value.
  2538.  
  2539.  
  2540. ░▒▓█  14.5  █▓▒░  (S)creen writes
  2541.  
  2542.     By default screen writes are done using BIOS calls.  You may set screen
  2543.   to go directly to video memory.  Direct screen are faster but may not be
  2544.   compatible with all video hardware.  BIOS screen writes will work on all
  2545.   IBM BIOS compatible computers.  BIOS screen writes will always be used when
  2546.   running under DESQview independent of the screen writes setting.
  2547.  
  2548.     When you select (S)creen writes you will be asked if you want to change
  2549.   the setting to the other value.
  2550.  
  2551.  
  2552. ░▒▓█  14.6  █▓▒░  (V)ideo driver
  2553.  
  2554.     By default the program will detect the type of graphics interface and use
  2555.   the proper driver.  If you have problems displaying the graphic displays and
  2556.   the program does not appear to be detecting the graphics interface properly
  2557.   you can use this configuration menu item to select a driver to use.  Refer
  2558.   to the section on compatibility for the interfaces supported.  When set to
  2559.   Auto, the interface detected will be shown in the menu.
  2560.  
  2561.     When you select (V)ideo driver you will be shown a menu of supported
  2562.   drivers, the interface detected (if its a supported one), and the current
  2563.   setting.  You will be asked to choose the driver to use.
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.                                   Page 43
  2580.  
  2581.  
  2582. ░▒▓█  14.7  █▓▒░  (L)og file mode
  2583.  
  2584.     Messages while extracting data from a capture file or merging another
  2585.   trader's database will be displayed on the screen and copied to a log file.
  2586.   The first extract or merge of a TWASSIST session can either overwrite the
  2587.   file or append to it.  All later extracts or merges during a session will
  2588.   append to the file.  This way you will always have all the messages from
  2589.   the session when you exit TWASSIST and can use it to review the messages or
  2590.   investigate problems.  If the mode is set to overwrite (the default) the
  2591.   the first extract or merge will overwrite the existing file so the file
  2592.   will have messages from just the last session.  If the mode is set to append
  2593.   the first extract or merge will add to the existing file.  This allows you
  2594.   to get a history of messages from previous session but at a cost of disk
  2595.   space as the file will continue to grow.
  2596.  
  2597.     When you select (L)og file mode you will be shown the current setting and
  2598.   asked if you want to change it to the other setting.  The default will be
  2599.   not to change it.
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.                                   Page 44
  2640.  
  2641.  
  2642. ╔════════════════════════════════════════════════════════════════════════════╗
  2643. ║ Section  15             Multitasking Environments                          ║
  2644. ╚════════════════════════════════════════════════════════════════════════════╝
  2645.  
  2646.     TWASSIST may be run in multitasking environments.  It has been tested
  2647.   under DESQview as noted in the section titled Compatibility.
  2648.  
  2649.  
  2650. ░▒▓█  15.1  █▓▒░  DESQview
  2651.  
  2652.     TWASSIST is DESQview aware and will give up unused CPU time while waiting
  2653.   for input.  The program will detect the maximum number of lines for the
  2654.   window.  Reports will pause between screens when this number of lines has
  2655.   been displayed.  If it appears the program is not detecting the right number
  2656.   of lines, you may set the number of lines to use in the ($) Registration and
  2657.   Configuration menu.
  2658.  
  2659.     Below are sample Change a Program screens from DESQview.  Refer to the
  2660.   section titled Compatibility for memory requirements.  If you have lots of
  2661.   memory, give TWASSIST a generous portion so you don't have to worry about
  2662.   situations that might cause the program to run out of memory.  Since the
  2663.   program can detect the maximum window size, not the actual zoomed size, it
  2664.   is recommended you set the starting height and width the same as the maximum
  2665.   height and width.  Some of the reports will display all their information in
  2666.   a single 25 line screen.  The menus were also developed to fit in a 25 line
  2667.   screen.  If you set the number of lines too small, lines at the top will
  2668.   scroll off the screen.
  2669.  
  2670.   NOTE: In the sample Change a Program screens, the maximum height is set to
  2671.         23 lines and the window is located at the top of the screen.  If the
  2672.         window for the communications program is set for 25 lines and located
  2673.         at the bottom of a 50 line screen, there will be one line of overlap
  2674.         (because of the extra lines DV uses for the border). In this situation
  2675.         the overlapped line would be the prompt line (e.g. More?) so all the
  2676.         report information is visible even when the communications window is
  2677.         on top.  Currently all the screens of TWASSIST will fit in a 23 line
  2678.         window.  There is no guarantee this will be true in future versions.
  2679.         Future versions will always fit in a 25 line window.
  2680.  
  2681.                                Change a Program
  2682.  
  2683.   Program Name............: TWASSIST
  2684.   Keys to Use on Open Menu: TA                         Memory Size (in K): 550
  2685.   ────────────────────────────────────────────────────────────────────────────
  2686.   Program...: c:\tw\twassist.exe
  2687.   Parameters:
  2688.   Directory.: c:\tw
  2689.   ────────────────────────────────────────────────────────────────────────────
  2690.   Options:
  2691.                   Writes text directly to screen.......: [N]
  2692.                   Displays graphics information........: [Y]
  2693.                   Virtualize text/graphics (Y,N,T).....: [Y]
  2694.                   Uses serial ports (Y,N,1,2)..........: [N]
  2695.                   Requires floppy diskette.............: [N]
  2696.  
  2697.  
  2698.  
  2699.                                   Page 45
  2700.  
  2701.  
  2702.                            15.1   DESQview (contd)
  2703.  
  2704.  
  2705.                       Change a Program Advanced Options
  2706.  
  2707.   System Memory (in K).......:   0   Maximum Program Memory Size (in K)..:
  2708.   Script Buffer Size.......:     0   Maximum Expanded Memory Size (in K):  100
  2709.   Text Pages: 1  Graphics Pages: 0   Initial Mode:        Interrupts: 00 to FF
  2710.   ────────────────────────────────────────────────────────────────────────────
  2711.   Window Position:
  2712.      Maximum Height:  23       Starting Height:  23       Starting Row...:   1
  2713.      Maximum Width.:  80       Starting Width.:  80       Starting Column:   1
  2714.   ────────────────────────────────────────────────────────────────────────────
  2715.                                 Shared Program
  2716.   Pathname..:
  2717.   Data......:
  2718.   ────────────────────────────────────────────────────────────────────────────
  2719.   Close on exit (Y,N,blank)......: [N]  Uses its own colors..............: [Y]
  2720.   Allow Close Window command.....: [Y]  Runs in background (Y,N,blank)...: [ ]
  2721.   Uses math coprocessor..........: [N]  Keyboard conflict (0-F)..........: [0]
  2722.   Share CPU when foreground......: [Y]  Share EGA when foreground/zoomed.: [Y]
  2723.   Can be swapped out (Y,N,blank).: [ ]  Protection level (0-3)...........: [0]
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.                                   Page 46
  2760.  
  2761.  
  2762. ╔════════════════════════════════════════════════════════════════════════════╗
  2763. ║ Section  16                     Automode                                   ║
  2764. ╚════════════════════════════════════════════════════════════════════════════╝
  2765.  
  2766.     Automode is a way of passing commands directly to TWASSIST and bypassing
  2767.   the interactive menu.  Automode is specified by using the /A option on the
  2768.   command line.  There are two ways to use automode.  You can either provide
  2769.   the automode commands on the command line or in a file.  For a few short
  2770.   commands it may be easier to use the command line (e.g. in a macro for
  2771.   mapping the universe using routes).  For long commands (e.g. notes) or lots
  2772.   of commands that may go beyond the DOS command line limit you can use the
  2773.   file.  The file would also work good for entering information while playing
  2774.   TW2002 on-line.  You can then run automode with the command file when it is
  2775.   convenient rather than doing it every time.
  2776.  
  2777.     When using automode you must provide the database name on the command
  2778.   line.  You will not be prompted for it.  The two ways of using automode
  2779.   are:
  2780.  
  2781.   TWASSIST database /A automode_commands...
  2782.  
  2783.     Automode will read commands from the command line.  Each argument after
  2784.     the /A will be interpreted as a separate automode command.
  2785.  
  2786.   TWASSIST database /A,cmdfile
  2787.  
  2788.     Automode will read commands from a file.  The cmdfile parameter is the
  2789.     pathname to the file.  Each line in the file will be interpreted as a
  2790.     separate automode command.  Blank lines will be ignored.  Lines with the
  2791.     first character a '#' will be ignored as comment lines.
  2792.  
  2793.  
  2794. ░▒▓█  16.1  █▓▒░  Important notes about automode
  2795.  
  2796.     Automode is made to be completely automatic.  Responses to prompts will
  2797.   be read from the command instead of from the keyboard.  Responses are
  2798.   separated by commas.  Every comma shown for a command is required.  If you
  2799.   do not provide enough parameters in the command then input for the remaining
  2800.   prompts will be redirected to the user and TWASSIST will wait for input in
  2801.   the normal interactive way.  After that command is completed automode will
  2802.   return to reading the next command in the normal way.  Extra commas at the
  2803.   end of a command will be ignored.
  2804.  
  2805.     It is VERY important to pass VALID parameters for every required parameter
  2806.   in an automode command.  If a parameter is missing or invalid it may be
  2807.   discarded and attempt to read the next parameter in its place.  The
  2808.   parameters would then be read out of sequence and would likely run short of
  2809.   parameters.
  2810.  
  2811.     Separate each parameter with a comma.  If there is a default you can use
  2812.   the comma separator with no value to use the default (e.g. one,,three,four).
  2813.   Do not use spaces in a command.  Trailing commas are required if shown.  Do
  2814.   not omit them.
  2815.  
  2816.     The maximum length of any automode command is 128 characters.
  2817.  
  2818.  
  2819.                                   Page 47
  2820.  
  2821.  
  2822.                 16.1  Important notes about automode  (cont'd)
  2823.  
  2824.     All messages on the screen will zip by.  There will be no pausing when one
  2825.   screen of info is completed.  Reports will continue until the end.  You must
  2826.   rely on the log, report, and other files for output.
  2827.  
  2828.  
  2829. ░▒▓█  16.2  █▓▒░  Automode commands
  2830.  
  2831.     There are a few parameters used by many of the automode commands.  They
  2832.   are:
  2833.  
  2834.     rpt_file       The report file to send output to.  All reports that allow
  2835.                    output to a file will always need this since that is the
  2836.                    only meaningful way to get output in automode.  Specify
  2837.                    the pathname to the report file or use the default.
  2838.  
  2839.     rm             The mode to write to the report file.  A single letter
  2840.                    A=append, O=overwrite.
  2841.  
  2842.     sector         A sector number.
  2843.  
  2844.     A/B/C          Letters or numbers separated by a slash are single
  2845.                    character choices as shown in the prompts in TWASSIST.
  2846.                    Enter just the single character for your desired selection.
  2847.  
  2848.     Automode commands are either a keyword recognized by automode or a key
  2849.   combination corresonding to the menus needed to access the feature.  Not
  2850.   all menu items are currently implemented in automode.  More are in work.
  2851.   Commands recognized by automode are:
  2852.  
  2853.     MENU
  2854.  
  2855.         Exits automode and goes to the menu.  There is no way to go back to
  2856.         automode.  Any remaining automode commands are ignored.
  2857.  
  2858.     SAVE_DB
  2859.  
  2860.         Save the database.  If it has not been modified nothing will happen.
  2861.         If the database has been modified it will be saved to disk.  You
  2862.         must use this command if you want the database saved.  There is no
  2863.         automatic save.
  2864.  
  2865.     ME,cap_file,
  2866.  
  2867.         Extract data from a capture file.  cap_file is the pathname to the
  2868.         capture file to read.  The capture file will not be deleted after
  2869.         it is processed.  If you want to delete the capture file, do it in
  2870.         the script or batch file that is running TWAssist in Automode.
  2871.  
  2872.     MA,sector,Y/N
  2873.  
  2874.         Modify avoid.  Specify Y to avoid sector or N to not avoid sector.
  2875.  
  2876.  
  2877.  
  2878.  
  2879.                                   Page 48
  2880.  
  2881.  
  2882.                       16.2  Automode commands  (cont'd)
  2883.  
  2884.  
  2885.     MB,sector,SET/CLEAR
  2886.  
  2887.         Modify busts.  Specify SET to set the busted date to today or CLEAR
  2888.         to clear the busted date.
  2889.  
  2890.     MN,sector,note
  2891.  
  2892.         Modify note.  Create or replace the note for the sector.  The note
  2893.         may include commas.  All text to the end of the command will be
  2894.         included in the note upto the maximum number of characters for a
  2895.         note.  The date will be automatically entered at the beginning of
  2896.         the note.  There is no way to remove the date.
  2897.  
  2898.     NS,string,rpt_file,rm,
  2899.  
  2900.         <Registered only>
  2901.         Search notes for those containing the string.
  2902.  
  2903.     NV,rpt_file,rm,
  2904.  
  2905.         View all notes.
  2906.  
  2907.     AF,rpt_file,rm,
  2908.  
  2909.         Asset report of fighter deployments.
  2910.  
  2911.     AM,rpt_file,rm,
  2912.  
  2913.         Asset report of mine deployments.
  2914.  
  2915.     AL,rpt_file,rm,
  2916.  
  2917.         Asset report of Limpet deployments.
  2918.  
  2919.     AA,rpt_file,rm,
  2920.  
  2921.         Asset report of active Limpets.
  2922.  
  2923.     PB,rpt_file,rm,
  2924.  
  2925.         Busted ports report.
  2926.  
  2927.     PL,rpt_file,rm,
  2928.  
  2929.         Likely locations of major ports report.
  2930.  
  2931.     PN,sector,rpt_file,rm,
  2932.  
  2933.         Ports nearest to sector.
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.                                   Page 49
  2940.  
  2941.  
  2942.                       16.2  Automode commands  (cont'd)
  2943.  
  2944.     PP,1/2/3/T/E,sector,rpt_file,rm,
  2945.  
  2946.         Paired ports.  Specify the type of pair to report:
  2947.  
  2948.         1 = Trade anything.
  2949.         2 = Trade Equipment with anything.
  2950.         3 = Trade Equipment with Organics.
  2951.         T = Trade all three products.
  2952.         E = Both buy Equipment.
  2953.  
  2954.     PU,sector,rpt_file,rm,
  2955.  
  2956.         Unknown status ports nearest to sector.
  2957.  
  2958.     RM,num,
  2959.  
  2960.         Mapping universe routes.  num is the approximate number of route
  2961.         commands to put in the file.
  2962.  
  2963.         NOTE:  The universe mapper saves some data calculations in the
  2964.                database.  The automode command sequence needs to include
  2965.                a SAVE_DB after the universe mapper so this data is saved
  2966.                and can be used in subsequent runs.
  2967.  
  2968.     RN,sector1,sector2,rpt_file,rm,
  2969.  
  2970.         Normal route.  sector1 is the starting sector and sector2 is the
  2971.         destination sector.  Both the route there and the return route
  2972.         will be reported.
  2973.  
  2974.     RT,sector1,sector2,rpt_file,rm,
  2975.  
  2976.         Transwarp route.  sector1 is the starting sector and sector2 is
  2977.         the destination sector.
  2978.  
  2979.     RS,rpt_file,rm,
  2980.  
  2981.         Space lane routes.
  2982.  
  2983.     RA,rpt_file,rm,
  2984.  
  2985.         Analyze warps report.
  2986.  
  2987.     SN,sector,rpt_file,rm,
  2988.  
  2989.         Sectors nearest to sector.
  2990.  
  2991.     SU,sector,rpt_file,rm,
  2992.  
  2993.         Unexplored sectors nearest to sector.
  2994.  
  2995.     SK,rpt_file,rm,
  2996.  
  2997.         Unknown sectors.
  2998.  
  2999.                                   Page 50
  3000.  
  3001.  
  3002. ░▒▓█  16.3  █▓▒░  Automode examples
  3003.  
  3004.     In the examples that follow two methods of using Automode will be shown,
  3005.   arguments on the command line and using the command file.  Commands lines
  3006.   may be shown on multiple lines here for clarity on the screen but they
  3007.   should be typed in as one long command at the DOS prompt.  The lines for
  3008.   the command file may be shown indented here for clarity but it is important
  3009.   that the first character of each line start in column 1 in the file.
  3010.  
  3011.     For these examples the following file names will be used:
  3012.  
  3013.          CAPTURE.TXT   This is the pathname to your capture file.
  3014.          GAME          This is the name of your datafile for this game.
  3015.          GAME.RPT      This is one of the report files used.
  3016.  
  3017.     For the first example let's say at the beginning of the session in the
  3018.   game you capture the various reports TWASSIST can read.  You want to
  3019.   update your database with this information, save the database, and update
  3020.   a report file with information on the unknown sectors and where your
  3021.   activated limpets are located.  This can be done using a command line like:
  3022.  
  3023.     TWASSIST GAME  /A ME,CAPTURE.TXT, SAVE_DB SK,GAME.RPT,O,  AA,GAME.RPT,A,
  3024.  
  3025.   Or using the command:
  3026.  
  3027.     TWASSIST GAME /A,UPDATEDB.CMD
  3028.  
  3029.   with the file UPDATEDB.CMD having the contents:
  3030.  
  3031.     # Extract information from the capture file
  3032.     ME,CAPTURE.TXT,
  3033.     # Save the database
  3034.     SAVE_DB
  3035.     # Get the unknown sectors report.  We want to overwrite the
  3036.     # existing report file with the new information.
  3037.     SK,GAME.RPT,O,
  3038.     # Get the activated limpet report.  We want to append this
  3039.     # to the file that has the unknown sectors report.
  3040.     SK,GAME.RPT,A,
  3041.  
  3042.     Because notes usually contain spaces and can be very long they don't
  3043.   work very well on the command line.  When modifying notes it is best to
  3044.   use the Automode command file.  One thing you could do is keep a text
  3045.   file handy that you update (by shelling to DOS or using an editor some
  3046.   communications programs have) with information as you play the days
  3047.   session.  Or maybe you have some scripts that run all the time while you
  3048.   play and watch for things and write the info to the command file.  Or
  3049.   maybe you have your own program that reads the capture file looking for
  3050.   things of interest and creates notes or other commands for the TWASSIST
  3051.   Automode command file.  You could end up with an UPDATEDB.CMD file that
  3052.   looks like this:
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.                                  Page 51
  3060.  
  3061.  
  3062.                       16.3  Automode examples  (cont'd)
  3063.  
  3064.  
  3065.     # Have TWASSIST read the capture file.
  3066.     ME,CAPTURE.TXT,
  3067.     # Received note from corp mate who was busted in sector 123.
  3068.     # I can clear my bust.
  3069.     MB,123,CLEAR
  3070.     # Found Ferrengal in sector 3245.
  3071.     # Create note and avoid sector.
  3072.     MN,3245,Ferrengal
  3073.     MA,3245,Y
  3074.     # Found home of enemy corp.
  3075.     MN,2215,Corp #2 planet, 20,000 fighters, 250 mines
  3076.     # Busted robbing cash from port
  3077.     MB,116,SET
  3078.     MN,116,Busted robbing cash from port.  Left 53k credits.
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.                                   Page 52
  3120.